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This publication describes the dif- 
ferences in internal logic of the control 
program that result from the inclusion of 
multiprogramming with a fixed number of 
tasks (MFT). It is assumed that the reader 
of this publication is thoroughly familiar 
with the basic operation of the control 
program. Only areas of difference are 
discussed in this publication. 


The manual is divided into four major 
sections. The Introduction describes con- 
trol program functions, control program and 
Main storage organization, and control pro- 
gram processing flow. The Nucleus Initial- 


izaticn Program section describes dif- 
ferences introduced by MFT into’ system 
initialization. The Supervisor section 


describes supervisor functions including an 
explanation of task dispatching in MFT. 


The Job Management section contains the 
changes to the job management components 


made by MFT. Job management is divided 
into three major components: reader/ 
interpreter, initiator/terminator, and out- 


put writer. Also described are the Queue 
Manager which is used by all three major 
job management components, the Communica- 
tions Task which handles operator-system 
communication, and the Master Scheduler 
Task which processes operator commands. 


Appendix A contains descriptions of 
major tables and work areas used by MFT. 
Appendix B contains descriptions of modules 
used by MFT. Appendix C contains MFT 
flowcharts. 
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In a single task environment, main 
storage is divided into two areas: the 
fixed area, and the dynamic area. In 
multiprogramming with a fixed number of 
tasks (MFT), the dynamic area is divided 
further into as many as fifty-two discrete 
areas called partitions. Figure 1. shows 
the division of main storage. 


The system area, located in the lower 
portion of main storage, contains the resi- 
dent portion of the control program, and 
contrel blocks and tables used by the 
system. The size of the system area 
depends on the number of partitions estab- 
lished by the user, and the control program 
options selected at system generation. 


Partitions are defined within the dynam- 
ic area, located in the upper portion of 
Main storage, at system generation. The 
number of partitions may be varied within 
the number specified at system generation, 
and the sizes and job classes of partitions 


may be redefined at system initialization 
or during operation. (See IBM System/360 


Operating System: Planning for Multipro- 


gramming with a Fixed Number of Tasks 
(MFT), Form C27-6939.) Each partition may 


be occupied by a processing program, or by 
contrcl program routines that prepare job 
steps for execution (job management rou- 
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INTRODUCTION 


tines), or handle data for a 
program (access method routines). 


processing 


MFT provides for the concurrent execu- 
tion of as many as 15 problem programs, 3 
input readers, and 36 output writers, each 
in its own fixed partition of main storage, 
as long as the total number of partitions 
does not exceed 52. The MFT system pro- 
vides for task switching among the _ tasks 
operating in the partitions, and between 
those tasks and the communications task and 
master scheduler task in the system area. 


Task dispatching in MFT differs from the 
primary control program (PCP) primarily in 
that task switching is required, and that 
certain system functions such as_ abnormal 
termination must be carried out so that 
other, unrelated, tasks are not affected. 
The dispatching priority of a task is 
determined by the relative position of the 


partition used to process the task. The 
highest-priority partition (PO) is at the 
highest address in storage. Successively 


lower partitions (P1 - P51) have correspon- 
dingly lower priorities. Control of the 
CPU is given to the program in the highest- 
priority partition that is ready. 


The integrity of programs operating 
under MFT 1isS preserved if the _ storage 
protection feature is included. MFT uses 

Partition (n-1) Partition 0 
High Address 


Zz ee ee 


System Area 
Legend: Fear] Required Portion of the Fixed Area 


/ | Optional Features 





n Number of Partitions Generated 


Figure 1. 


Main Storage Organization in MFT 
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the 16 protection keys to prevent a euser 
job from modifying the control program or 
another job; it uses the two operating 
states of the CPU to restrict the use of 
control and I/O instructions. 


Because many components of MFT are simi- 
lar to those of PCP and multiprogramming 
with a variable number of tasks (MVT), many 
of the modules for a given MFT component 


are the same for the comparable component 
in either PCP or MVT. Therefore, this 
publication describes differences between 


MFT and the other configurations. The 
corresponding PCP and MVT routines are 
described in the following IBM System/360 
Operating System program logic manuals and 
are referenced where applicable: 


Fixed Task Supervisor, Form Y28-6612 
MVT Supervisor, Form Y28-6659 


MVT Job Management, Form Y28-6660 


Information on modified or new routines for 
MFT is contained in the three sections that 
follow this introduction. 


The Nucleus Initialization Program (NIP) 
section describes the changes’ that have 


been made to NIP for MFT. The major area 
of change is’ the deletion of some of the 
NIP functions, which are now performed by 
other system tasks (e.g., system initiali- 
zation is performed by the master scheduler 
task in MFT). 


The Supervisor section describes’ the 
task management modifications made to the 
Supervisor for MFT. The major area of 
change has been in the initialization of 
main storage. 


The Job Management section describes 
modifications and additions to the routines 
for processing communications with the pro- 
grammer and the operator. The major 
changes are in the master scheduler’ task, 
and the MFT initiator. Other modifications 
have been made to the queue manager, the 
reader/interpreter, system output writer, 
and system task control routines. 


FUNCTIONS OF THE CONTROL PROGRAM WITH MFT 
As in PCP and MVT, the control program 
routines of MFT have three major functions: 
job management, task management, and data 
management. 
JOB MANAGEMENT 
Job management is the processing of 


communications from the programmer and 


10 


operator to the control program. There are 
two types of communications: operator com 
mands, which start, stop, and modify the 
processing of jobs in the system, and job 
control statements, which define work being 
entered into the system. Processing of 
these commands and statements is referred 
to as command processing and job process- 
ing, respectively. 


TASK MANAGEMENT 

Task management routines monitor and 
control the entire operating system, and 
are used throughout the operation of both 
the control and processing programs. Task 
Management has six major functions: 

e Interruption supervision 

e Task supervision 

e Main Storage supervision 

e Contents supervision 

e Overlay supervision 


e Timer supervision 


The task management routines are collec- 
tively referred to as the "supervisor." 


DATA MANAGEMENT 


Data management routines control all 
operations associated with input/output 
devices: allocating space on volumes, 
channel scheduling, storing, naming, and 
cataloging data sets, moving data between 
Main and auxiliary storage, and handling 
errors that occur during input/output 
operations. Data management routines are 
used by processing programs and _ control 


program routines that require data move- 
ment. Processing programs use data manage— 
ment routines primarily to read and write 
required data, and also to locate input 
data sets and to reserve auxiliary storage 
space for output data sets of the process- 
ing program. 

Data management routines are of five 
categories: 


e Input/Output (1/0) supervisor, which 
supervises input/output requests) and 
interruptions. 


e Access methods, which communicate with 
the I/O supervisor. 


e Catalog management, which maintains the 
catalog and locates data sets on auxil- 
iary storage. 
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e Direct-access device space management 
(DADSM), which allocates auxiliary 
storage space. 


e Open/Close/End-of-Volume, which per- 
forms required initialization for I/0 
Oferations and handles end-of-volume 
conditions. 

The operation of these routines is identi- 
cal with MVT and is described in the 


following IBM System/360 Operating System 
program logic manuals: 


Input/Output Supervisor, Form Y28-6616 
Sequential Access Methods, Form Y28-6604 


Indexed Sequential Access Methods, Form 
Y28-6618 


Basic Direct Access Method, Form 
Y28-6617 


Graphics Access Method, Form Y27-7113 
Catalog Management, Form Y28-6606 


Direct Access Device Space Management, 
Form Y28-6607 


Input/Output Support (OPEN/CLOSE/EOV), 
Form Y28-6609 


CONTROL PROGRAM ORGANIZATION 


The control program resides on auxiliary 
storage in three partitioned data _ sets 
creat ed when the system is generated. 
These data sets are: 


e The NUCLEUS partitioned data set (SYS1. 
NUCLEUS), which contains the Nucleus 


Initialization Program (NIP) and the 
resident portion of the control 
program. 


e The SVCLIB partitioned data set (SYS1. 
SVCLIB), which contains nonresident SVC 
routines, nonresident error-handling 
routines, and the access methods 
routines. 


e The LINKLIB partitioned data set (SYS1. 
LINKLIB), which contains other nonresi- 
dent control program routines and IBM- 
supplied processing programs. 


RESIDENT PORTION OF THE CONTROL PROGRAM 


The resident portion (nucleus) of the 
control program resides in SYS1.NUCLEUS. 
It is made up of those routines, control 
blocks, and tables that are brought into 


Main storage at initial program loading 
(IPL) and are never overlaid by another 
part of the operating system. The nucieus 
is loaded into the fixed area of main 
storage. 


The resident task management routines 
include all of the routines that perform: 


e Interruption supervision 
e Main storage supervision 
e Timer supervision 


They also include portions of the routines 
that perform: 


e Task supervision 
e Contents supervision 
e Overlay supervision 


These routines are described in this publi- 
cation, and in the program logic manual IBM 


System/360 Operating System: Fixed Task 
Supervisor, Form Y28-6612. 


The resident job management routines are 
those routines of the communications task 
that receive commands from the operator. 
The MFT communications task is described in 
this publication. 


The resident data management routines 
are the input/output supervisor and, 
optionally, the BLDL routines of the parti- 
tioned access method. These routines are 
described in the following IBM System/360 
Operating System program logic manuals: 


Input/Output Supervisor, Form Y28-6616 
Sequential Access Method, Form Y28-6604 


The user may also select access method 
routines to be made resident. These rou- 
tines are referred to as resident access 
methods (RAM), and are loaded during system 
initialization rather than during Open pro- 
cessing. RAM modules reside adjacent to 
the higher end of the system queue area 
unless the BLDL table is resident (see 
Figure 1). 


Normalily-transient SVC routines (i.e., 
types 3 and 4 SVC routines) can be made 
resident through the RSVC option, specified 
by the’ user. At IPL, NIP loads these 
routines adjacent to the higher end of the 
RAM modules. If there is no resident BLDL 
table or RAM modules, the routines are 
loaded adjacent to the higher end of the 
system queue area. (See Figure 1.) 
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Figure 2. Division of Main Storage 
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NONRESIDENT PORTION OF THE CONTROL PROGRAM 


The nonresident portion of the control 
program comprises routines that are loaded 
into main storage as they are needed, and 


which can be overlaid after their comple- 
tion. The nonresident routines operate 
from the partitions and from two sections 


of the nucleus called transient areas 
(described below). 
MAIN STORAGE ORGANIZATION 

Main storage in MFT is organized simi- 


larly to main storage in MVT, except that 
MFT does not use a link pack area (see 
Figure 1). 
FIXED AREA 


PCP and MVT) the fixed 
area is that part of main storage into 
which the nucleus is loaded at IPL. The 
Storage protection key of the fixed area is 
zero so that its contents can be modified 
by the control program only. The fixed 
area also contains two transient areas into 
which certain nonresident routines are 
loaded when needed: the SVC transient area 
(1024 bytes) and the I/O supervisor tran- 
Sient area (1024 bytes). These areas are 


In MFT (as in 


used by nonresident SVC routines and non- 
resident I/O error-handling routines, 
respectively, which are read from 


SYS1.SVCLIB. 


Each transient area contains only one 
routine at atime. When a nonresident SVC 
or error-handling routine is required, it 
is read into the appropriate transient 
area. The transient area routines operate 
with a protection key of zero, as do other 
routines in the fixed area. 


System Queue Area 


The system gueue area (SQA) is’ estab- 
lished by NIP adjacent to the fixed area 


and provides’ the main storage Space 
required for tables and queues built by the 
control program. The SQA must be at least 
1600 bytes for a minimum two-partition 
system. Its storage protection key is zero 
so that it can be modified by control 
program routines oniy. Data in the system 
queue area indicates the status of all 
tasks. 


DYNAMIC AREA 


Figure 2 shows how the contents of each 
partition in the dynamic area are organized 
and how they are related to the rest of 
main storage. Routines are brought into 
the high or low portion of an MFT partition 
Similarly to the way routines are brought 
into the entire dynamic area of PCP. Job 
Management routines, processing programs, 
and routines brought into storage via a 
LINK, ATTACH, or XCTL macro instruction, 
are loaded at the lowest available address. 
The highest portion of the partition is 
occupied by the user parameter area and 
user save area. The next portion of the 
partition iS occupied by the task input/ 
output table (TIOT) which is built by a job 
Management routine (I/O Device Allocation 
routine). This table is used by data 
Management routines and contains informa- 
tion about DD statements. 


Each partition may be used for a problem 
program as well as for system tasks 
(readers, initiators, and writers). When 
the control program requires main storage 
to build control blocks or work areas, it 
obtains this space from the partition of 
the processing program that requested the 
Space. Access method routines and routines 
brought into storage via a LOAD macro 
instruction are placed in the highest 
available locations below the task input/ 
output table. 


Working storage and data areas are 


assigned from the highest available storage 
in a partition. 
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THEORY OF OPERATION 


Figure 3 describes the overall processing flow through each job cycle. These 
paragraphs describe the processing performed by various components of the control program 
as it loads the nucleus, reads control statements, initiates the job step, causes 
processing to begin or end in other partitions, and terminates the job step. 










i a a a aa aa a a ar ale | 
| | 
| 
i To load the nucleus, the operator sets | 
| the LOAD UNIT switches to the device on | 
| Load which the system residence volume is | 
| IPL mounted, and presses the LOAD button on the | 
| Program operator control panel. This causes an IPL | 
| record to be read and to be given control. | 
| This record causes the second IPL record to | 
| be read, which in turn, enables the rest of | 
| the IPL program to be read into main | 
| oa ucleus | 
| | 
| The IPL program searches the volume | 
| label of the system residence volume to | 
| locate the volume table of contents (VTOC). | 
| The VTOC is then searched for the address | 
; of the nucleus data set (SYS1.NUCLEUS). | 
| The nucleus is brought into the system | 
| area, and NIP is brought into the dynamic | 
| area. NIP receives control from the IPL | 
| program. It performs both required and | 
| optional initialization for control program | 
| Operation including initializing the Con- | 
| munication Vector Table (CVT), and general | 
| system initialization, such as determining | 
| user options. After completing its pro- | 
| cessing, NIP passes control to the master | 
| scheduler task (MST) which initializes main | 
| Task storage. | 
: | 
| Benes Vk Partitions are established by the master | 
| Changes? Make scheduler at system initialization accord- | 
| Reavestee ing to the sizes and job class(es) estab- | 
| ohana: lished at system generation by the PARTITNS | 
| macro instruction. The MST also places a | 
| copy of the Initiator/Terminator into each | 
| Initialize scheduler-size partition; a copy of the | 
| Work small partition module is placed in each | 
{ Queues small partition. The communications task | 
| receives control from the MST and communi- | 
| cates with the operator to request any | 
[ Interpret START Reader partition changes. After the requested | 
| Commones START Writer changes, if any, have been made by the | 
| START INIT definition routines, the work queues are | 
| SET initialized. The automatic commands are | 
| displayed, and the READY message is issued. | 
| Vy | 
| | 
| | 
Ua a a a ee eee J 


Figure 3. MFT Theory of Operation (Part 1 of 4) 
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When the required SET and START commands 
are entered, control is given to the master 
command routine. After the communicaticns 
task completes processing of the commands, 

La) a copy of the Reader/Interpreter (reader) 
is brought into its appropriate partition. 
If a START writer command is entered, a 
copy of a writer is also brought into the 
specified partition(s). 


Bring Writer 
Into Its When the reader gets control, it reads 
Assigned control statements and data from the input 
ceed job stream. Information from the JOB, 
EXEC, and DD statements controls the execu- 
tion of each job step. This information is 
Bring Reader placed in the following tables: 
Into Its 
Assigned e Job control table (JCT) for the job 
Partition being read 





e Step control table (SCT) for the step 


being read 
READER 


e Data set enqueue table (DSENQ) for the 
job being read 
Read and an 
ae 


Interpret e Job file control block (JFCB) and step 
Control Statements input/output table (SIOT) for each data 
set being used or created by the job 
step 
Build Tables and 

Enter Job on input e Volume table (VOLT) containing each 
mPpropticte: Inpus Work volume serial number to be used by the 


k e 
wore vee Queues Job “ 


Information from these tables and control 
blocks is updated with information in the 
data control block (DCB) and data _ set 
control block (DSCB) or volume label when a 
data set is opened during step execution. 


Write Data in 
Input Stream 
onto Direct-Access 
Storage Device 





The reader then places these updated 

control blocks into the input work queue 
corresponding to the CLASS parameter on the 

Bring JOB statement. Data sets in the input 
Initiator/ stream are written onto a direct-~access 
Terminator storage device for later use by the problem 


Into progran. 
Partition 





After the reader has completed process- 
ing all input for a job and has entered the 
job on an input work queue, all initiators 
ay that are waiting for that job class are 

posted. If the job is for a small parti- 
tion, the small partition module is also 
posted. 


ee a a a a = a oe oe ee oe ee ee ee ee ee ee ee ee ee ee ee Le ee ee 


Figure 3. MFT Theory of Operation (Part 2 of 4) 
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INITIATOR/TERMINATOR 







Determine Step to 
Be Initiated 








Locate Input 
Data Sets 










Assign 
Input/Output 
Devices to Data 
Sets 










Allocate 
Auxiliary 
Storage Space 







Write Tables 
and 
Control Blocks 





SUPERVISOR 


Bring Problem 
Program Into 
Partition 











After receiving control, the initiator/ 
terminator prepares to initiate the highest 
priority job in its primary input work 
queue. Using information which the reader 
extracted from the DD statement, the 
initiator/terminator processes’ the user 
accounting routine, in addition to the 
following: 


Locates Input Data_ Sets: The Allocation 


routine, running aS ae subroutine of the 
initiator/terminator, determines the volume 
containing a given input data set by 
examining the JFCB, or by searching the 
catalog. This search is performed by a 
catalog management routine entered from 
allocation. (A description of the routines 
that maintain and search the catalog is 


given in IBM System/360 Operating System: 


Catalog Management, Program Logic Manual, 
Form Y28-6606.) 


Allocates I/O Devices: A job step cannot 
be initiated unless there are enough I/0 
devices to fill its needs. Allocation 
determines whether the required devices are 
available, and makes specific assignments. 
If necessary, messages are issued to the 
operator to request the mounting of 
volumes. 


Allocates Auxiliary Storage Space: Direct 


access volume space reguired for output 
data sets of a job step is acquired by the 
allocation routine, which uses the Direct 
Access Device Space Management (DADSM) rou- 
tines. (A description of the operation of 
the DADSM routines is given in the publica- 


tion IBM System/360 Operating System: 
Direct Access Device Space Management, Pro- 
gram Logic Manual, Form Y28-6607.) 


The JFCB, which contains information 
concerning the data sets to be used during 
step execution, iS written on auxiliary 
storage. This information is used when a 
data step is opened, and when it is closed, 
the job step is terminated. 


The initiator causes itself to be 
replaced by the problem program it is 
initiating (if for a large partition), or 
initiates the job in a small partition. 


The problem program can be an IBM- 
supplied processor (e.g., COBOL, linkage 
editor), or a user-written program. The 
problem program uses control program ser- 
vices for operations such as loading other 
programs and performing I/O operations. 


Figure 3. MFT Theory of Operation (Part 3 of 4) 
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The problem program processes until it 
terminates either normally or abnormally, 
though it may not retain exclusive control 
of the CPU. Control always is received by 
the highest priority task that is ready to 





Allow Highest execute. 
Priority Ready 
Task to 
Execute When the problem program terminates, the 
Supervisor receives control. The supervi- 
sor uses the OPEN/CLOSE/EOV routines to 
in close any open data control blocks. (These 
Sets routines are described in IBM System/360 
Operatin System: Input/Output Support 
(OPEN/CLOSE/EOV) , Program Logic Manual, 
Form Y28-6609.) 
EOV 
Set Up for Dump, Under abnormal termination conditions, 
i Reduite the supervisor may also provide special 


ae termination procedures, such aS a_e storage 
Initiator/ dump. The supervisor passes control to the 
Terminator initiator/terminator, which is either 
brought into the partition in which ter- 
Mination iS to occur, or is brought into 
the large partition to terminate a small 


INITIATOR/TERMINATOR partition. 


The initiator/terminator releases’ the 

User I/O devices, and disposes of data sets used 
Accounting and/or created during the job step by 
nouns reading tables prepared during initiation 
(JCT, SCT, TIOT, etc.). These tables 
Dispose of include information such as disposition of 
Data Sete: data sets. It then executes an installa- 
Matter Mesqees tion accounting routine if one is provided. 





Enqueve Work . ; . . 
for Output Output At job termination, an entry is made on 


Writer on Work the user specified output work queue; later 
ae mauedes the problem program output data can be 
written by a system output writer from a 
system direct-access storage device to a 





user-specified device. The initiator/ 
Lay terminator then initiates the next job 
step. 


An output writer operates concurrently 
with readers, problem programs, and other 
writers. When the START command is issued 
for a writer, the writer dequeues the first 
entry in the specified output (SYSOUT) 





SYSTEM OUTPUT WRITER 


Dequeue Entry From 


Apprapitate Sysout queue. If no requests have been enqueued 
Quaus in that output queue from the problem 
programs, the writer is placed in a wait 

Write Data and condition until a job is terminated that 
Messages onto has system messages or output data sets. 
User-Specified After the entry is dequeued from the output 


Device 


queue, the writer transmits the data _ sets 
to the specified card punch, magnetic tape 
unit, or printer. When the last record has 
been processed, the writer deletes the 


Dequeue the Next Crime queue entry before dequeuing the next 


Delete Entry 
From the Queve 


Entry From the 
Gieia entry. 





Figure 3. MFT Theory of Operation (Part 4 of 4) 
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NUCLEUS INITIALIZATION PROGRAM 


The Nucleus Initialization Program (NIP) 
in MFT is essentially the same as that used 
for MVT. However, some routines have been 
removed, either because their functions are 
not required by MFT or because they are 
performed by other system tasks (e.g., the 
initialization of main storage is handled 
by the master scheduler task to support 
partition redefinition). This section 
describes those areas where MFT NIP differs 
from MVT NIP. A complete description of 
NIP for MVT can be found in IBM System/360 


Operating System: Initial Program Loader 


and Nucleus Initialization Program, Program 
Logic Manual, Form Y28-6661. 


NIP is a control section included by the 
linkage editor in the nucleus during system 
generation. The IPL program loads’ the 
nucleus and NIP and then passes control to 
NIP. NIP performs required and optional 
initialization functions for control pro- 
gram operation. Initialization includes 
nucleus table initialization and general 
system initialization. 


NIP first operates in its own environ- 
ment, uSing its stand-alone I/O routine. 
As it initializes the nucleus, NIP begins 
to use system routines, including the I/0 


Supervisor, to complete nucleus initializa- 
tion. 


GENERAL SYSTEM INITIALIZATION 

The primary area of difference between 
MFT NIP and MVT NIP is in general system 
initialization. Differences are: 

e Defining Control Program Areas 

e Determining User Options 

e Redefining the System Queue Area 


e Locating the BLDL List and Resident 
Modules 


e Preparing Main Storage 


These differences are described in the 


following paragraphs. 


DEFINING CONTROL PROGRAM AREAS 


In MFT, NIP alters the contents of the 
master scheduler task boundary box to 
define an area including all of main 
storage from the end of the fixed area _ to 
the highest addressable byte of main 
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storage. (The original boundary box con- 
tents are saved to be passed to master 
scheduler initialization routine IEFSD569 
in a parameter list.) The area assigned to 
the master scheduler task is not used 
during NIP execution. NIP establishes’ the 
system queue area (SQA) adjacent to the 
nucleus. The SQA boundaries are determined 
by the upper boundary of the nucleus and 


the SQA Size specified during system 
generation. 
Main storage may be expanded by includ- 


ing IBM 2361 Core Storage (core storage) 
units in the system. Main Storage Hierar- 
chy Support for IBM 2361 Models 1 and 2 
permits access to either processor storage 
(hierarchy 0) or core storage (hierarchy 
1). Each partition established during sys- 
tem generation is described by a boundary 
box. The first half of the boundary box 
describes the processor storage partition 
segment and the second half describes the 
core storage partition segment. Any parti- 
tion segment not assigned main storage in 
the system has the applicable boundary box 
pointers set to zero. If a partition is 
established entirely within hierarchy 1, 
the processor storage pointers in the first 
half of the partition's boundary box are 
set to zero. If a partition segment is not 
generated in core storage, the core storage 
pointers in the second half of the parti- 
tion*s boundary box are set to zero. If 
core storage has been included in the 
system, but is off-line, the second half of 
the boundary box will contain zeros. If 
core storage is excluded from the system, 
the second half of the boundary box is not 
generated. 


DETERMINING USER OPTIONS 


After NIP issues the message SPECIFY 
SYSTEM PARAMETERS, the operator may enter 
the following MFT user options (using the 
keywords indicated): 


e A larger or smaller system queue area 
(SQS=) 


e Additional modules for the resident 
access method routines (RAM=) 


e A resident module list resulting from 
BLDL information (BLDL=) 
routines 


e Additional resident SVC 


(RSVC=) 
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REDEFINING THE SYSTEM QUEUE AREA 


The system queue area operates under a 
protection key of zero. It contains system 
control blocks which might be destroyed by 
problem programs if placed in problem pro- 
gram partitions. These control blocks 
include command scheduling control blocks 
(CSCBs) and all control blocks associated 
with ENQ/DEQ. If the communications’ task 
encounters a threshold condition, write-to- 
operator (WTO) buffers are also constructed 
in the system queue area. 


To respecify the system queue area, the 
operator enters the size as the number of 
total bytes required. NIP readjusts the 
area's free queue element (FQE) and resets 
the area‘s upper boundary accordingly. It 
then rounds the size to aé double word 
boundary. If BLDL, RAM, and RSVC options 
were not specified during system generation 
or are not selected during IPL, NIP rounds 
the size toa 2K boundary in systems with 
storage protection. 
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Note: MFT and MVT construct the system 
queue area in the same place in main 
storage, but the SQA has a different func- 
tion in each systen. 


LOCATING THE BLDL LIST AND RESIDENT MODULES 


After the system queue area is estab- 
lished, the optional BLDL list is con- 
structed, and optional RAM and RSVC modules 
are loaded into the area adjacent to the 
system queue area. If the BLDL option was 
chosen at system generation, a list of the 
SYS1. LINKLIB modules specified by the user 
is constructed. If the RAM and RSVC 
options were chosen at system generation, 
the optional linkage library and svc 
library modules specified by the user are 
loaded. 


The communications vector table (CVT) 
field CVTNUCB, containing the lowest 
Storage address in the dynamic area, is 
adjusted so that the BLDL list and RAM and 


RSVC modules are included in the fixed 
area. 

Note: In MVT, the BLDL list and RAM and 
RSVC modules are in the link pack area; 


there is no link pack area in MFT. 


MAIN STORAGE PREPARATION 


When NIP completes its functions it 
constructs a request block (RB) and an XCTL 
macro instruction (specifying master sched- 
uler initialization routine IEFSD569) at 
the low address of the temporary master 
scheduler area defined previously (see 
Defining Control Program Areas). NIP 
places the address of this RB in master 
scheduler task TCB field MTCBRBP. (The 
original contents of TCBRBP are saved and 
passed to IEFSD569 in a parameter list 
along with the original master scheduler 
task boundary box contents.) NIP sets 


master scheduler task TCB field TCBFLGS to 
make the master scheduler task dispatch- 
able, and then branches to the dispatcher. 


The dispatcher gives control to the 
master scheduler task causing execution of 
the XCTL instruction which NIP placed in 
the temporary master scheduler area. The 
master scheduler initialization routine is 
brought into the temporary master scheduler 
area and begins executing. Figure 4, 


excluding the medium shaded area, illus- 


trates main storage at completion of NIP 
before branching to the dispatcher. Figure 
4, excluding the light shaded area, illus- 


trates main storage when the master sched- 
uler initialization routine receives  con- 
trol from the dispatcher. 


For a description of the master sched- 
uler initialization routine see “Master 
Scheduler Task" in the Job Management sec- 
tion. Figure 5 illustrates main storage 
(four partition example) at completion of 
master scheduler initialization. When the 


initialization routine completes process- 
ing, it branches to the dispatcher. 


Initializing the Partitions 


During master scheduler initialization 
the operator must accept automatic START 
commands or enter START commands manually. 
When a START command is’ processed, the 
partition number specified in the command 
is determined, and a CSCB is built. The 
CSCB (see Appendix A) is used for communi- 
cation between the command scheduling rou- 
tines (SVC 34) and the command execution 
routines. The address of the cCSCB is 
placed in the partition information biock 
(PIB) of the specified partition, and the 
partition is posted. The PIB for. each 
partition contains information used by con- 
mand processing and scheduler routines. 
(See Appendix A for a description of the 
PIB, and “Initiator/Terminator" in Job 
Management for a discussion of its use.) 


After the initialization routine 
pletes processing, the dispatcher gives 
control to the master scheduler router 
routine. When this routine completes pro- 
cessing, it returns to the dispatcher which 
begins searching the TCB queue. The high- 
est priority task posted through START 
command processing receives control. The 
XCTL macro instruction addressed by the 
partition’'s RB is executed and the Job 
Select module (IEFSD510) or Small Partition 
module (IEFSD599) is brought into the par- 
tition. When an interruption occurs and 
the partition can no longer retain control, 
the dispatcher gives’ control to the next 
posted partition. This process’ continues, 
enabling all posted partitions to receive 
control and to execute the XCTL instruction 
placed in them by the initialization 
routine. 


com~ 
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Temporary : 
Master Dynamic 
Scheduler Area 
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PRB __XCTLIEFSD569_|__ 0000 FOE 
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RSVC 
System 
Queue Area 3 
0000 FQE 
Communications Task Master Scheduler oer 
Area 
MS TCB 
TCBRBP 
Nucleus 
Low Address 
Legend: eee Contents of the Dynamic Area During IPL and NIP. 
Contents of the Dynamic Area After The Master Scheduler Task ~ 
Receives Control on Completion of NIP. 
one Optional Features 
Figure 4. Main Storage During Execution of NIP 2 
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Figure 5. Main Storage at Termination of Master Scheduler Initialization 
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SUPERVISOR 


The MFT Supervisor manages the operation 
of the control program and processing pro- 
grams. Job management selects jobs for 
execution, allocates devices and storage to 
the step to be executed, and gives control 
to the program that represents the step. 
After receiving control, a program is known 
as a task and becomes the responsibility of 
the Supervisor. As many as 15 job-step 
tasks may operate in the system concurrent- 
ly with system tasks. Each task must _ he 


isolated so it does not interfere with any 
other task. To do this, each job-step task 
operates in its own partition in main 
storage. If the system has the optional 


storage protection feature, each partition 
is assigned a unique protection key (1-15). 
The resident portion of the control pro- 
gram, including some supervisor routines, 
occupies a fixed area of main storage and 
operates under a protection key of zero. 


To maintain control of the computing 
system, the supervisor must perform many 
services. Routines within the supervisor 
are grouped into general categories depend- 
ing upon the services which they perform. 
These categories are: 


Interruption Supervision: All supervisor 
activity begins with an interruption. The 


five types of interruptions are: supervi- 
Sor call, timer/external, input/output, 
program, and machine. When an interruption 
occurs, the interruption handling routine 
for the type of interruption that occurred 
gains control. The interruption handling 
routine then passes control to those parts 
of the control program that perform the 
services required as a result of the inter- 
ruption. Many of the services which must 
be performed are included in other’ general 
categories of the supervisor. 


Task Supervision: The supervisor maintains 


control information including the current 
status of program and interruption request 
blocks, task control blocks, and event 


control blocks. 


Contents Supervision: The supervisor keeps 
records of the status and characteristics 
of all programs in each partition of main 
storage, initiates program fetch for the 
dynamic loading of programs, and maintains 
the active request block queue. 


Main Storage Supervision: Within each par- 
tition, the supervisor allocates and 


releases main storage space for a task on 
request, and maintains a record of all free 
storage space within each partition. 
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Timer Supervision: The supervisor sets and 
maintains a clock, and honors requests’ for 
time intervals and exact time. 


Overlay Supervision: The supervisor mon- 
itors the flow of control between segments 


of a program operating in an overlay struc- 
ture established by the user through the 
linkage editor. 


INTERRUPTION SUPERVISION 


With the exception of the dispatcher 
which is described below, the interruption 
supervisor of MFT functions as described in 


IBM System/360 Operating System: Fixed- 


Task Supervisor, Program Logic Manual, Form 
Y28-6612. 


When an interruption occurs and is ser- 
viced, the task which had been executing 
May relinquish control of the CPU. Control 
must always be given to the highest priori- 
ty ready task. The transfer of control 
from one task to another is called task 
Switching and is accomplished by the task 
dispatcher. When an interruption handling 
routine completes processing an interrup-— 
tion, it branches to the task dispatcher 
rather than returning control to the inter- 
rupted program. Type 1 EXIT is the only 
interruption handling routine which may 
return control directly to the interrupted 
program. Figure 6 illustrates how the task 
dispatcher receives control after an inter- 
ruption has been serviced. 


THE DISPATCHER (MACRO IEAAPS) 


The dispatcher gives control to the 
highest priority task ready to execute. It 
uses information located by communication 
vector table (CVT) fields CVTHEAD and 
CVTITCBP, and if the time-slicing feature is 
in the system, field CVTTSCE. 


Field CVTHEAD addresses a queue of task 
control blocks (TCBs). This TCB queue is 
arranged in dispatching priority order 
beginning with the highest priority task. 
The highest priority TCB, the communication 
task TCB, is followed by the master sched- 
uler task TCB, and one TCB for each of the 
partitions generated in the system (in 
ascending order by partition number). 
Figure 7 illustrates the TCB queue. 


Any number of partitions (up to 52) may 
be specified during system generation. 
Partitions must be numbered consecutively 
beginning with zero. Note that in Figure 7 
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Figure 6. MFT Supervisor 


there is a TCB for partition 1, but parti- 
tion 1 is assigned no storage space. This 
illustrates a partition which was specified 
at system generation but which has_ been 
made inactive. If a partition is not 
specified during system generation, no TCB 
is constructed. If, for example, only 3 
partitions (0 through 2) are specified at 
system generation, then only three TCBs are 
constructed and partitions 3 through 51 do 
not exist. 


All of the TCBs in the system are 
chained together through TCB field TCBTCB. 
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In each TCB, this field contains the 
address of the next TCB on the queue. The 
TCBTCB field of the last TCB on the queue 
contains zero. 


CVT field CVTTCBP addresses’ two full 
words called NEW and OLD. The first word 
(NEW) contains either zero or the TCB 
address for the task to be given control. 
The second word (OLD) contains the TCB 
address for the task currently in control. 
NEW can be set by any of the supervisory 
routines associated with task switching 
(WAIT, POST, ENQ/DEQ, Manual Purge). When 
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a supervisory routine determines that the 
task currently in control can no longer 
retain control, it sets NEW to zero. When 
a supervisory routine determines the new 
task to be given control, it inserts’ the 
TCB address for that task in NEW. 


CVT field CVTTSCE contains the address 
of the time-slice control element (TSCE). 
This field is used by the dispatcher in 
determining the next time-slice task to 
receive control, providing time-slicing was 
specified as a system generation option. 
The format of a TSCE is explained later in 
this section. 


When the interval timer is in use and a 
user accounting routine is supplied, the 
dispatcher accumulates the total amount of 
time used to execute a job step. Each time 
a new job step is dispatched, the dispatch- 
er stores the time from the hardware timer 
in the PTIMER field of IEATPC (pseudo clock 
area). When control is returned to the 
dispatcher, it calculates the elapsed time 
by subtracting the stored value from the 
current value of the hardware timer. The 
dispatcher adds the result to the TCBTCT 
field in the task's' TCB. Time is not 
calculated for the job step if it is 
dispatched in a wait state. 


Dispatching a Task 


When the dispatcher receives control, it 
first schedules any requests for system 
asynchronous exit routines. Then it deter- 
mines if NEW equals OLD (see Chart 02). If 
so, no task switch is indicated. If neces- 
sary, the dispatcher enqueues timer ele- 
ments for the task. It then returns to the 
task currently in control. 


If NEW does not equal OLD, a task switch 
is indicated. If job/step CPU timing is 
included in the system, the dispatcher 
calculates the job step time for OLD, and 
increments the job time accumulator in the 
TCB. If necessary, the dispatcher dequeues 
timer elements associated with the task 
currently in control. Then it determines 
if NEW equals zero. 


If NEW does not equal zero, it contains 
the TCB address for the task to be given 
control. The dispatcher sets OLD equal to 
NEW, and enqueues timer elements if neces- 
sary. Additionally, if job/step CPU timing 
is included in the system, the dispatcher 
stores the interval timer value in the 
pseudo timer field of IEATPC. Control then 
passes to the new task. 


If NEW equals zero, the dispatcher must 
examine the TCB queue to determine which 
task should be given control. This 
examination begins with the TCB addressed 
by OLD. (For a task of higher priority 
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than OLD to receive control, the address of 
its TCB must be inserted in NEW bya 
supervisory routine. ) 


When examining a TCB to determine if its 
associated task should be given control, 
the dispatcher first determines if the 
request block (RB) of the program executing 
under the TCB is waiting. This is done by 
examining field XRBWT in the RB addressed 
by TCB field TCBRBEP. If the RB is not 
waiting, the dispatcher examines TCB field 
TCBFLGS to determine if the task is dis- 


patchable. If so, the dispatcher sets NEW 
and OLD to the address of the TCB and 
enqueues timer elements (if necessary). 


job/step CPU timing is 
included in the system, the dispatcher 
stores the interval timer value in the 
pseudo timer field of IEATPC. Control then 
passes to the new task. 


Additionally, if 
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In one case, the dispatcher does not 
pass control directly to the new task. If 
TCB field TCBRBP for the task to be given 
control addresses an SVRB for a transient 
Svc routine, a check is made to determine 
the contents of the double word XCNTCC (in 
IEAATAO0O) which contains the name of the 
routine presently in the SVC transient 
area. If the routine names in XCNTCC and 
the SVRB are identical, the dispatcher 
passes control to the new’ task. If they 
are not identical, the Transient SVC 
Refresh routine (IEAARFO0) brings the 


required routine into the Svc transient 
area and then returns to the dispatcher. 
Since NEW and OLD have already been set 
equal, the dispatcher need only enqueue 
timer elements if necessary and pass con- 


trol to the new task. 


If the RB for a task is waiting or the 
task is nondispatchable, the task is not 
ready to receive control. The dispatcher 
examines TCB field MTCETCB to obtain the 


address of the next TCB on the queue. 
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dispatcher then examines this TCB to iden- 
tify whether it is ready to receive con- 
trol. This process continues until a ready 
task is found or until the end of the queue 
is reached (indicated by a zero in TCBTCB). 


If no task is able to receive control, 
the dispatcher sets the resume PSW wait bit 
of the TCB addressed by OLD. This PSW is 
then loaded, placing the CPU in ae wait 
condition. The resume PSW is located in 
field XRBPSW of the RB addressed by tTcCB 
field TCBRBP. 


Figures 8 and 9 illustrate how control 
is switched assuming a three partition 
system in which P1 is inactive (see Figure 
7). All tasks are dispatchable except task 
Pi. Initially, only the communications 
task and master scheduler task are waiting. 
Because task PO is’ the highest priority 
task which is dispatchable and not waiting, 
it is given control. Task PO has already 
enqueued and received exclusive control of 
a rescurce which task P2 will later enqueue 
(see Figure 9). 


Dispatching the Communications Task and 
Master Scheduler Task 


Figure 8 illustrates how control passes 
to the communications task and master 
scheduler task through the dispatcher. In 
the example illustrated, the communications 
task receives control in order to read a 
DEFINE command from the operator console. 


Initially, the task in PO has received 
control from the dispatcher and is execut- 
ing. The operator presses the REQUEST key 
to indicate that he wishes to entera 
command from the console. An I/O interrup- 
tion is generated and control passes to the 
I/O supervisor which identifies the inter- 
ruption as an attention signal. The I/O 
supervisor then passes control to the’ con- 
sole interruption routine which issues a 
POST macro instruction. The POST routine 
posts the attention ECB and sets the com- 
munications task RB to a non-wait condi- 
tion. Because the communications task is 
of higher priority than the task in parti- 
tion 0, the POST routine places the address 
of the communications task TCB in location 


NEW. Control then passes to the 
dispatcher. 
The dispatcher gives control to _ the 


communications task which issues SVC 72 to 
read the console and then issues SVC 34 to 
process the command. SVC 34 processes some 
commands completely but must pass’ control 
to the master scheduler resident command 
processor routine to complete processing 
the DEFINE command. (See “Command Process- 
ing" in the Job Management section for a 
complete description of SVC 34 and the 
Master scheduler’ task.) Svc 34 issues a 


POST macro instruction to post the master 
scheduler task. The POST routine sets the 
master scheduler RB to a non-wait condition 
and gives control to the dispatcher. 
Because the master scheduler task is of 
lower priority than the communications 
task, locations NEW and OLD remain 
unchanged and the dispatcher returns’ con- 
trol to the communications task. 


The communications task issues a WAIT 
macro instruction and waits on an ECB. The 
WAIT routine sets the communications’ task 
RB in a wait state and sets location NEW to 
zero. The dispatcher then receives control 
and searches the TCB queue. Since the 
master scheduler task is the next’ ready 
task on the TCB queue, the address of the 
master scheduler TCB is placed in locations 
NEW and OLD, and the dispatcher passes 
control to the master scheduler. 


The master scheduler completes process- 
ing the DEFINE command and then issues 
WAIT. The WAIT routine sets location NEW 
to zero and passes control to the dispatch- 
er which searches the TCB queue until it 
finds a task ready to receive control. In 
Figure 8, control returns to the task which 
was executing before the operator entered 
the DEFINE command. 


Dispatching Tasks by Partition Priority 


Figure 9 illustrates task switching 
among tasks executing in partitions. 


A. The task in partition PO (task PO) is 
the highest-priority ready task and is 
given control by the dispatcher. When 
task PO issues a WAIT on an ECB, an 
interruption occurs and control passes 
to the WAIT routine. 

B. The WAIT routine places the RB for 
partition 0O in a wait condition and 
sets location NEW to zero. It then 
passes control to the dispatcher which 
searches the TCB queue beginning with 
the TCB for partition 0. Since task 
PO is waiting and task Pi is non 
dispatchable, the dispatcher passes 
control to task P2, the highest 
priority task ready to execute. When 
task P2 attempts to enqueue a resource 
through use of the ENQ macro instruc 
tion, an interruption occurs and con- 
trol passes to the ENQ routine. 


Cc. The resource iS unavailable because 
task PO has already enqueued it. 
Therefore, task P2 cannot’ continue 
executing. The enqueue routine places 
zero in location NEW and then passes 
control to the dispatcher which 
searches the TCB queue. Since task P2 
is the last task on the queue, the 
dispatcher sets the wait bit in the 
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resume PSW of task P2. The dispatcher 
rasses control to task P2, placing the 
CPU in a machine wait condition. 


D. While the CPU is waiting, an interrup- 
tion occurs signifying the completion 
of the event for which task PO was 
waiting. The POST routine receives 
control and posts the ECB for task PO 
which is now able to resume control. 
The POST routine places the TCB 
address for task PO in location NEW 
and gives control to the dispatcher. 
The dispatcher sets OLD equal to NEW 
and gives control to task PO. Task PO 
executes and when finished using the 
resource it has enqueued, it issues a 
CEQ macro instruction. 


E. An interruption occurs and the DFO 
routine receives control. The queue 
element for task PO is removed from 
the resource queue. The next element 
on the resource queue is for task P2. 
The resource iS assigned to task P2 
and its RB is placed in a $non-wait 
condition. The DEQ routine then com- 
pares the priority of the task which 
has keen in control with the priority 
of the task which iS now ready. 
Because task PO has a higher priority 


than task P2, location NEW remains 
unchanged. The DEG routine passes 
control to the dispatcher which 


returns control to task PO. 


Dispatching a Task (with Time Slicing) 


If time slicing was selected as a system 


generation option, the user can select a 
number cf contiguous partitions to be a 
time-slice group. The tasks executing in 


time-sliced partitions have equal priority. 
Each ready task in the time-slice group 
executes for a selected amount of time, the 
time-slice length, and then loses control 
to the next ready task in the time-slice 
group. The time-slice group is supervised 
through use of a time-slice control element 
(TSCE) shown below. 


FIRST - Address of the fist time-slice TCB on the TCB queue 


LAST - Address of the last time-slice TCB on the TCB queue 


NEXT -~ Address of the next time-slice TCB to be dispatched 


LENGTH - Time-slice length ( in milliseconds ) 
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When time-slicing is selected, the dis- 
Fatcher performs functions in addition to 
those explained in the preceding fara- 
graphs. The following text describes the 
additional dispatcher functions, and paral- 
lels the flow of data shown in Chart 03. 


NEW EQUALS OLD: The dispatcher first 
determines if NEW equals OLD. If it does, 
the dispatcher furtner determines if the 
task represented by OLD is a time-slice 
task. 


OLD a Time-Slice Task: If OLD is a _ time- 
slice task, the dispatcher determines if 
the time-slice interval has expired; i.e., 
if the time-slice queue element (TQE) has 
been removed from the timer queue. 


If the interval nas expired, the next 
ready time-slice task must be dispatched. 
The dispatcher searches’ the time-slice 
group beginning with the TCB addressed by 
TSCE NEXT (see preceding explanation of 
TSCE fields). When the TCB addressed by 
TSCE LAST is reached, the dispatcher checks 
the TCB addressed by TSCE FIRST, until a 
ready task is found or until all time-slice 
TCBs have been checked. 


When a ready task is found, TSCE NEXT is 
updated, the time-slice TOE is enqueued, 
and the ready task is dispatched. If no 
time-slice tasks are ready, the dispatcher 
searches the TCB queue for the highest- 
priority ready task. 


Tf the intervat has not expired, i-.e., 
the time-slice TCE has not been dequeued, 
controi is returned to the interrupted 
task. 


OLD Not a Time-Slice Task: If OLD is not a 
time-slice task, control is returned to the 
interrupted task. 


NEW NOT EQUAL TO OLD: If NEW does not 
equal OLD, the dispatcher determines if OLD 


is a time-slice task. 


OLD Time-Slice Task--NEW Equal Zero: If 


OLD is a time-slice task and NEW equals 
zero, the time-slice TGE is dequeued for 
the current task. The dispatcher then 
searches (using the TSCE) for the next 
ready TCB in the time-slice group. If no 
time-slice TCBs are ready, the dispatcher 
searches the TCB queue for the highest- 
priority ready task. 


OLD Time-Slice Task--NEW Not Equal to Zero: 
If OLD is a time-slice task and NEW does 


not egual zero, the dispatcher determines 
if NEW is a time-slice task. 


If NEW is 
represented by OLD, if 
patched. (The time-slice 


a time-slice task, the task 
ready, is redis- 
TOs® remains on 
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If the task represented by OLD 
is not ready, the time-slice TQE is 
dequeued, and the dispatcher searches 
(using the TSCE) for the next ready time- 
Slice task. If no time-slice tasks are 
ready, the dispatcher searches the TCB 
queue for the highest~-priority ready task. 


the queue.) 


If NEW is not a time-slice task, the 
time-slice TQE is dequeued and the NEW task 
is dispatched. 


OLD Not a Time-Slice Task: If OLD is not a 
time-slice task, the dispatcher finds the 
next highest-priority ready task. It does 
this by either obtaining the TCB address 
from NEW or, if NEW is zero, by scanning 
the TCB queue. If the highest-priority 
ready task is not a time-slice task, it is 
dispatched. If the highest-priority ready 
task is a time-slice task, the dispatcher 


finds (using the TSCE) the next ready task 
in the time-slice group. The time-slice 
TOE is enqueued, and the task is 
dispatched. 


ABEND SERVICE ROUTINE 


ABEND is a type 4 SVC routine that is 
used for both normal and abnormal task 
termination. ABEND terminates the task 
under which it is running, resets’ the 
partition, and passes control to the job 
management routines for continued 
processing. 


ABEND can be entered directly from the 
problem program or system task via an ABEND 
macro instruction, or indirectly through 
the ABTERM service routine. (ABTERM sched- 
ules the execution of ABEND for system 
routines that detect an error but cannot 
issue an ABEND macro instruction.) The SVC 
SLIH (second level interruption handler) 
fetches the first load module of ABEND and 
passes control to it. Control is passes 
from one ABEND load module to the next via 
an XCTL instruction (SVC 7). The flow of 
control between modules for normal and 
abnormal termination is shown in Chart 04. 


The ABEND functions provided for MFT are 
similar to those provided for PCP. Modules 
IEAGTMOA, IEAGTMOO, IEAGTMO6, and IEAGTMO5, 
exist only in MFT and are described below. 
The remaining modules are also used in PCP 


and are explained in IBM System/360 Operat- 


ing Systen: Fixed Task Supervisor, Form 
Y¥28-6612. (For a brief description of all 


ABEND modules used in MFT, see "MODULE 
DESCRIPTIONS," IN Appendix B of this 
publication. ) 


ABEND STAE Test Routine (IEAGTMOA) 


IEAGTMOA first sets a bit to prohibit 
asynchronous exits for this task and tests 
for normal end. If this is a normal end, 
the normal completion code is stored in the 
TCB, and control passes to ABEND module 
IEAGTMOO. If the task is abnormally ter- 
minating, IEAGTMOA determines if STAE (spe- 
cify task asynchronous exit) processing is 
indicated for this task (via a user-issued 
STAE macro instruction). 


If a STAE was issued, i.e., TCB field 
TCBNSTAE does not equal zero, IEAGTMOA 


checks for a valid STAE and performs as 
follows: 


e If the ABEND was issued by the Purge 


routine during STAE processing, i.e., 
the purge bit in TCB field TCBNSTAE 


equals one, the resume PSW of the Purge 
RB routine is set to the address of an 
EXIT instruction (SVC 3). IEAGTMOA 
then issues an EXIT instruction. 


Note: If ABEND was not entered from 
the Purge routine, i.e., the purge bit 
in TCB field TCBNSTAE equals zero, 
IEAGTMOA stores the abnormal completion 
code in the TCB. 


e If the Task is being abnormally ter- 


minated because of a timer expiration 


or an operator cancel, STAE processing 
is bypassed and IEAGTMOA exits to ABEND 


module IEAGTMOO. (Since task timing 
and cancellations from the console are 
directly controlled by the user, the 
ABEND was intentional and should not be 
handled by the STAE routines. ) 


e If STAE processing is already in pro- 
qress, regular ABEND processing con- 


tinues, since the STAE routine can 
process only once per STAE issued. 
IEAGTMOA thus exits to ABEND module 
IEAGTMOO. 


e If this is a valid request for STAE 
processing, i-.e., none of the above 


conditions are true, IEAGTMOA tests TCB 
field TCBPIE for zero. If it is not 
zero, IEAGTMOA frees the PIE and zeros 
TCBPIE. Thus, subsequent program 
checks will not be handled by a user 
routine which may not be designed for 
such a program check. IEAGTMOA then 
exits to STAE module IEAATMOB. 


If a STAE has not been issued, or if all 


STAEsS have been processed, i.e., TCB field 
TCBNSTAE equals zero, IEAGTMOA determines 


if this is a graphics or an ABEND recursion 
and if this is a graphics job with a 
Graphics Abend Exit routine. 
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e If this is a _ recursion, or if the task 


abnormally terminating is not a_gra- 


phics job, IEAGTMOA exits to ABEND 
module IEAGTMOO. 
e If this is a_graphics job, IEAGTMOA 


passes control to the Graphics Abend 
routine. At the completion of this 
routine, control is returned either to 


the caller via an Svc 3 (if the task is 
resumable, i.e., the ABEND was issued 
by a user program or caused by a 
program check in a user routine, and if 
he wishes to resume processing) or to 
IEAGTMOA, which exits to ABEND module 
EAGTMOO. 


ABEND Initialization Routine (IEAGTMOO) 


This module first determines if it was 
entered from STAE. If so, it branches to 
the section of code that accomplishes’ the 
WIOR purge function. IEAGTMOO cancels the 
task timer element so that a timer inter- 
ruption will not occur during ABEND pro- 


cessing. It then dequeues all interruption 
queue elements (IQEs) belonging to _ the 
task, since these cannot be scheduled dur- 


ing ABEND processing. 


If a system or problem program ‘must 
complete* bit is set in TCB field TCBFLGS, 
or if the task is a system task, IEAGTM0O 
branches to the System Quiesce routine, 
IEAGTWST (see “System Quiesce Routine"), 
which places the partition in a wait state 
and prints a message to the operator. 


Note: Processing in the other partitions 
can be restarted and continue until all 
jobs already enqueued have been completed. 
The system will then be in a wait state and 
corrective action must be taken.) If the 
above conditions do not exist, IEAGTMO0O 





purges the WQEs (WTO Queue Elements) and 
the RPQEs (Reply Queue Elements) for this 
task. 


IEAGTMOO tests to see if it was entered 
from STAE and if this is a normal end to 
determine the next load module. 


ABEND Input/Output Purge Routine (IEAGTM06) 


IEAGTM06 purges I/O requests and I/O 
operations via a macro instruction version 
of the SVC Purge Routine, which is 
assembled within this module. (See “SVC 
PURGE ROUTINE" in Input/Output Supervisor, 
Form Y28-6616.) This prevents errors’ that 
can cause recursion to the ABEND routine. 
(Since ABEND frees main storage, an I/0 
operation that is not halted can cause 
information to be read into, or an ECB to 
be posted in main storage that may have 
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been relocated, thus destroying data or 
programs. ) RQES (request queue elements) 
removed from the request queue are returned 
to a list of available RQEs for reuse by 
the I/O supervisor. 


IEAGTM06 also dequeues, from the SIRB, 
IQEs (interruption queue elements) repre- 
senting requests for the use of I/O error 
handling routines. IEAGTM06 passes control 
to ABEND module IEAATM01. 


ABEND Termination Routine (IEAGTM05) 


ABEND termination routine IEAGTMO5 is 
the final ABEND module for both normal and 
abnormal termination. For normal termina- 
tion it is entered from IEAGTMO6. On 
abnormal termination it may have been 
entered from any of the previous modules of 
ABEND except initialization routine 
IEAGTMOO. 


If a dump message is required, i.e., if 
ABDUMP has been initiated but has failed to 
complete, IEAGTM0O5 causes message IEA0O02I, 
“ABEND/ABDUMP ERROR, NO ABEND OUTPUT" to be 
printed. IEAGTMO05 issues a CLOSE macro 
instruction for any open data sets. The 
timer queue and the main storage supervisor 
queue are purged, and fields in the TCB are 
reset so that a new task may be initiated. 
If an indicative dump is provided by 
IEAATMO3, it is moved to the upper boundary 
of the partition. 


IEAGTMO5 does not directly transfer con- 
trol to a job management routine. In the 
first 72 bytes of the problem program 
partition, IEAGTM05 establishes a dummy 
PRB, an XCTL parameter list, and a set of 
instructions including an XCTL to a_ step 
deletion routine. The XRBLNK field of the 
dummy PRB contains a pointer to the TCB. 
The dummy PRB therefore becomes the only RB 
queued for this task. 


The dummy PRB is then placed at the 
beginning of the RB queue. This ensures 
that the XCTL instruction will be the next 
operation executed for this task after 
IEAGTMO5 has completed. For scheduler-size 
partitions, step deletion routine IEFSD515 
gains control, at entry point GO. For 
small partitions, control is passed to 
entry point SMALLGO in small partition 
routine IEFSD599. 


SYSTEM QUIESCE ROUTINE (IEAGTWST) 


The system quiesce routine, which is 
part of the nucleus, is branched to during 
abnormal termination processing when the 
task scheduled for abnormal termination 
processing is in “must complete" status or 
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is a system task, or when entry to abnormal 
termination processing was caused by an 
error that occurred during ABEND process- 
ing. The system gquiesce routine, whose 
address is located in the CVTXWTO field of 
the CVT, performs the same functions as in 
MVT : the failing task is placed in wait 
state, and a message indicating that a CPU 
wait state has been averted and is issued 
to the operator instructing him to allow 


the system to quiesce (to schedule no 
further jobs). Control is then returned to 
the supervisor enabling the system for 


interruptions and permitting the other par- 
titions of the system to continue process- 
ing. See Termination Procedures in MVT 
Supervisor for a more detailed description 
of the system quiesce routine. 


STAE SERVICE ROUTINE 


The STAE service routine is a type 3 SVC 
routine which prepares the task to inter- 
cept scheduled abnormal termination (ABEND) 
processing. When the STAE macro instruc- 
tion (resulting in an SVC 60) is issued, 
the STAE service routine is invoked. The 
STAE service routine creates a 16-byte STAE 
control block (SCB), which contains’ the 
addresses of a user-written STAE exit rou- 
tine and parameter list. When the task 
becomes scheduled for abnormal termination, 
the ABEND/STAE interface routine (ASIR) is 
given control by the ABEND routine. ASIR 
returns control to the user at the STAE 
exit routine address. After the STAE exit 
routine has been executed, control is 
returned to ASIR. ABEND processing con- 
tinues for the task as previously scheduled 
unless the STAE exit routine has requested 
that a STAE retry routine be scheduled. If 
a STAE retry routine is provided by the 
user, ASIR reestablishes the task scheduled 
for ABEND processing and exits, giving 
control to the dispatcher so that the STAE 
retry routine is executed next. See IBM 
System/360 Operating System: System  Pro- 
grammer‘s Guide, Form C28-6550, for further 
explanation of the STAE macro instruction. 


The five modules which perform the func-— 
tions of the STAE macro instruction are the 


STAE service routine (IGC00060) and the 
four ABEND/STAE interface modules 
(IGCOBO01C, IGcocoic, IGCODOI1C, and IGC- 
OE01C). These modules perform the same 


functions as in MVT, (see IBM System/360 
eratin System: MVIT Supervisor, Form 
Y28-6659) with the exception both 1Gc0Cc01C 
and IGCOEO1C pass control via the XCTL 
Macro instruction to the ABEND module IEAG- 
TMOA to purge the WTOR queue before giving 
control the next ASIR module (IGCODO01C). 


TASK SUPERVISION 


The task supervisor maintains the status 
of tasks within the system. Task supervi- 
sion service routines: 


e Maintain task control blocks. 
e Enter tasks into the wait state. 


e Post completed events in the _ event 


control block. 


e Maintain control levels 
request blocks. 


indicated by 


The routines which accomplish these 
functions are WAIT, POST, ENQ, and DEQ. 


Each task within the operating system 
has an associated task control block (TCB). 
The TCB contains task-related information 
and pointers to additional control blocks 
containing task-related information. The 
control blocks used by MFT are the same as 
those used by PCP except for the addition 
of the partition information block (PIB) 
which is described in Appendix A. The last 
three bytes of the word at displacement 124 
(decimal) of each partition TCB contain the 
address of the associated PIB. Figure 10 
shows the major control blocks maintained 
by the supervisor and their relationship to 
the TCB. 


Task supervision is described in IBM 


System/360 Operating System: Fixed-Task 
Supervisor, Program Logic Manual, Form Y28- 


6612. Additional information applicable to 
MFT is presented in the following 
paragraphs. 


THE ATTACH ROUTINE (MACRO IEAAAT) 

In MFT, the ATTACH and LINK macro 
instructions are handled identically. An 
RB is created for the requested progran, 
the program is brought into the requesting 
task's partition, and its RB is chained to 
the RB queue for that partition. See IBM 


System/360 Operating System: Supervisor 


and Data Management Services, Form C28-6646 
for further explanation of the ATTACH macro 


instruction with MFT. 


THE WAIT ROUTINE (MACRO IEAAWT) 


The WAIT routine is 
that described in 


not changed from 


Fixed-Task Supervisor, 


Program Logic Manual. However, the user 
should remember the effect the optional 


validity checking feature has on WAIT. If 
validity check is included in the system 
and the program issuing the WAIT macro 
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instruction is not in supervisor mode, the 
WAIT routine checks that: 


1. The boundary alignment of the ECBs is 
correct. 


2. The storage protection key of the ECBs 
is that of the issuing progran. 


3. The addresses specified do not exceed 
main storage boundaries of the 
machine. 


Because of point 2, it is not possible for 
one partition to WAIT on an ECB within 
another partition. 


THE POST ROUTINE (MACRO IEAAPT) 


The POST routine, like the WAIT routine, 
is unchanged from that described in Fixed- 
Task Supervisor Program Logic Manual. 
Validity checking applies to POST in the 
Same way it applies to WAIT. 
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System Control Block Relationship 


THE ENQ/DEQ ROUTINE (IEAGENQ1) 


The ENQ/DEQ routine provides a means of 
controlling serially reusable resources. 
This is done by assigning unique names 
consisting of a Qname and an Rname to each 
serially reusable resource. The ENQ/DEQ 
routine controls access to resources by 
building resource queues consisting of a 
queue control block (QCB) for each Qname 
and Rname specified in an ENQ macro 
instruction and a queue element (QEL) to 
represent each actual request. ENQ/DEQ is 


fully described in IBM System/360 Operating 


System: MVI. Supervisor, Program Logic 
Manual, Form Y28-6659. ENQ/DEQ for MFT is 


identical to MVT except as described below. 


In MFT, resource queues are located in 
the system queue area (subpool 255). Loca- 
tion IEAOQCBO in the ENQ/DEQ routine con- 
tains the address of the first queue con- 
trol block in the queue. There is only one 
TCB for each job step in MFT. Therefore, 
the “must complete" function of ENQ/DEQ 
applies only to the system, not to job 
steps. If "system must complete” is speci- 
fied by a task, all other tasks in the 


PICA 


Active RB Queue 


Loaded Program List 


ECB 


ECB 
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system are set non-dispatchable until the 
task which specified “system must complete" 
completes its processing. 


CONTENTS SUPERVISION 


Contents supervision routines determine 
the location of requested programs and 
fetch them into main storage if necessary. 
They also maintain records of all programs 
in main storage. Programs requested via 
LINK or XCTL macro instructions are sched- 
uled for use by placing a request block 
(RB) for each program on the requesting 
task's active request block queue. 


Programs requested Via LOAD macro 
instructions are represented by RBs on the 
loaded program list. 


There are six types of request blocks in 
MFT: 


e Program Request Block (PRB) -- repre- 
sents a nonsupervisory routine that 
must be executed in the performance of 
a task. PRBs are created by the con- 
tents supervision routines that perform 
the LINK or XCTL functions. 


e Supervisor Request Block (SVRB) -- 
represents a supervisory routine. 
SVRBs are created by the SVC interrup- 
tion handling routines. 


e Interruption Request Block (IRB) -- 
controls a routine that must be 
executed in the event of an asynchro- 
nous interruption. IRBs are created in 
advance of an interruption by the CIRB 
routine at the user's request, but not 
placed on an RB queue until an inter- 
ruption actually occurs. 


Interruption Request Block 
-- used only for the system I/0 
There is only one SIRB in 


e System 
(SIRB) 
error task. 
the system. 


e Loaded Program Request Block (LPRB) -- 
controls programs brought in by a_ LOAD 
macro instruction. LPRBs also control 
sections of programs that are specified 
by the IDENTIFY macro instruction. 
LPRBs are created by the contents 
Supervision routines that perform the 
LOAD function. 


e Loaded Request Block (LRB) -- a short- 
ened form of LPRB and controls’ load 
modules that have the “load only" 
attribute. It is invalid to issue 
ATTACH, LINK, or xXCTL macro instruc— 
tions to these load modules. LRBs_ are 
created by the routines that perform 
the LOAD function. 


Contents supervision alters the active 
RB queue and the loaded program list, and 
fetches programs into main storage in 
response to LINK, ATTACH, LOAD, and XCTL 
Macro instructions. The routines which 
service these macro instructions are de- 
scribed below. 


LINK SERVICE ROUTINE (MACRO IEAATC) 


The LINK service routine determines if 
the RB of the requested routine is on the 
loaded program list. If it is and is 
inactive, LINK places the RB on the active 
RB queue. If the requested RB is not on 
the loaded program list (or if it is on the 
list, but is active), the LINK routine 
constructs an RB for the requested routine, 
places the RB on the active RB queue, and 
fetches the requested routine into main 
storage. 


ATTACH SERVICE ROUTINE (MACRO IEAAAT) 


The ATTACH macro instruction is’ handled 
as a LINK macro instruction. For a con- 
plete explanation, see “The ATTACH Macro 
Instruction" under the topic Task Supervi- 
sion. 


LOAD SERVICE ROUTINE (MACRO IEAATC) 


The LOAD service routine first deter- 
mines if the requested routine is a RAM 
module (if the resident access method (RAM) 
option was specified at system generation). 
If so, the entry point of the routine is 
passed to the requesting routine in regis- 
ter zero. If the routine is not a RAM 
module, LOAD searches’ the loaded program 
list for the RB of the requested routine. 
If it is found, the LOAD routine increments 
the RB use count by one and returns the 
entry point of the requested routine in 
register zero. 


If the requested routine is not found on 
the loaded program list, the LOAD routine 
branches to the FINCH routine to load the 
requested routine into storage. On return 
from the FINCH routine, the LOAD routine 
initializes the requested routine's RB and 
places it on the loaded program list, sets 
the RBs use count to one and branches to 
the LINK routine to issue the SVC EXIT 
instruction. 


XCTL SERVICE ROUTINE (MACRO IEAATC) 


The XCTL service routine first deter- 
mines if XCTL was issued by a type 3 or 4 
SVC routine (if the resident SVC (RSVC) 
option was chosen at system generation.) 
The xXCTL routine determines if the SVC 
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routine is an RSVC routine. If it is, the 
routine need not be brought into main 
storage. If the requested routine is not 
an RSVC, the XCTL routine branches to the 
FINCH routine to locate the routine on the 
Svc library and to bring it into the SVC 
transient area. The XCTL routine initial- 
izes the routine's RB and executes an SVC 
EXIT instruction. 


If the XCTL macro instruction was not 
issued by a transient SVC routine, the XCTL 
routine dequeues the primary RB and each 
minor RB of the issuer from the active RB 
queue. The routine which issued the XCTL 
Macro instruction and its RB are removed 
from storage unless the routine was brought 
in via a LOAD macro instruction. If the 
requested routine is on the loaded program 
list and is inactive, the XCTL routine 
branches to the LINK routine to place the 
RB on the active queue and to issue an SVC 
EXIT instruction. 


If the XCTL routine determines that the 
scheduler has issued an XCTL macro instruc- 
tion to branch to the problem program, the 
XCTL routine zeroes out the TCBICT field of 
the TCB so that the optional Job/Step CPU 
Timing entry can be made. 


If the RB of the requested routine was 
not found inactive on the loaded program 
list, the xXCTL routine branches’ to the 
FINCH routine to bring in the routine. On 
return from the FINCH routine, the XCTL 
routine branches to the LINK routine to 
place the RB on the active queue and issue 
an SVC EXIT instruction. 


Additional contents supervision services 
are provided by the IDENTIFY, DELETE, and 
SYNCH service routines. IDENTIFY and DE- 
LETE alter the loaded program list. SYNCH 
alters the active request block queue. 


IDENTIFY SERVICE ROUTINE (IEAAIDOO) 


The IDENTIFY service routine builds and 
initializes a minor request block to 
describe a routine specified in the parame- 
ters of the IDENTIFY macro instruction. 
The IDENTIFY routine chains this minor RB 
to the loaded program list and to the RB of 
the routine which contains the identified 


routine. The IDENTIFY routine returns’ to 
the issuer by issuing an Svc EXIT 
instruction. 


DELETE SERVICE ROUTINE (IEAADLOO, IEABDLOO) 


The DELETE service routine determines if 
the routine specified in the DELETE macro 
instruction is a RAM module. If it is, the 
DELETE routine exits immediately. If the 
routine is not a RAM module, the DELETE 
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routine finds the routine's RB on the 
loaded program list and decrements the use 
count in the RB by one. If the use count 
reaches zero, the DELETE routine dequeues 
the routine from the loaded program list 
and issues a FREEMAIN macro instruction to 
release the storage occupied by the speci- 
fied routine and its RB. On return from 
the FREEMAIN routine, the DELETE routine 
repeats the deleting process for each minor 
RB belonging to the specified routine. The 
DELETE routine returns by branching to the 
type 1 SVC exit. 


SYNCH SERVICE ROUTINE (IEAASYOQO) 


The SYNCH service routine uses GETMAIN 
to obtain 32 bytes of main storage from the 
lower end of the partition for the creation 
of a program request block (PRB). The PSW 
in the PRB is initialized by the SYNCH 
routine to address the location specified 
in register 15 by the issuer of the macro 
instruction. The SYNCH routine sets’ the 
PSW completely enabled in problem program 
mode, with the protection key recorded in 
the task control block. After the PRB is 
created and initialized, the SYNCH routine 
queues it on the active request block queue 
below the SVRB for SYNCH, and returns by 
issuing an SVC EXIT instruction. 


Additional information describing PCP 
and MFT Contents Supervision can be found 


in Fixed-Task Supervisor, Program Logic 


Manual. 


MAIN STORAGE SUPERVISION 


In MFT, the main storage supervisor: 
1. Allocates space via the GETMAIN SVC 
2. Deallocates space via the FREEMAIN SVC 


3. Allocates 
area 


Space in the system queue 


4. Checks validity of requests that are 
to be serviced 


5. Maintains the pointers and control 


blocks necessary to supervise main 
storage 
Each job is assigned to a partition in 


which it must operate. Each partition has 
an associated TCB which contains a pointer 
(TCBMSS field) to the main storage boundary 
box for that partition. The main storage 
supervisor, in response to GETMAIN or FREE- 
MAIN macro instructions, obtains storage 
from either the problem program partition 
or the system queue area. Obtaining 
storage space from the system queue area is 
the basic difference in main storage super- 
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vision between MFT and PCP. In MFT, a 
System task can issue a GETMAIN macro 


instruction specifying subpool 255 and the 
required storage will be allocated from the 
system queue area. The system queue area 
is used to obtain space for system control 
blocks which might be destroyed by problem 
programs if they were placed in problem 
program partitions. The system tasks which 
request storage space from subpool 255 are: 


e The CSCB creation module of SVC 34, for 
CSCBS 


e The ENQ/DEQ processing routines of task 
supervision, for all control blocks 
associated with ENQ/DEQ 


e The communications task, for write-to- 
operator (WTO) buffers if all WTO buff- 
er storage space specified during sys- 
tem generation is unavailable 


Note: Although subpools are not created in 
MFT (as in PCP and MVT), problem programs 
and system tasks may specify subpools in 
the GETMAIN macro instruction. However, 
all main storage requests from problem 
programs are allocated from the highest 
available main storage in the partition 
which issued the GETMAIN. 


The boundary box for the system queue 
area is located in master scheduler resi- 
dent data area IEESD568 (see Appendix A). 
The master scheduler resident data area is 


addressed by the cCVIMSER field in the 
Communications Vector Table. 

When problem programs issue GETMAIN 
macro instructions specifying a _ subpool 


from QO through 127, storage is allocated 
from the high-address portion of the parti- 
tion in which the GETMAIN macro instruction 
was issued. When problem programs attempt 
to issue a GETMAIN macro instruction speci- 
fying a subpool from 128 through 255, the 
program is abnormally terminated. When 
system tasks issue a GETMAIN macro instruc- 
tion specifying a subpool from 0 through 
127, storage is allocated from the low- 
address portion of the partition; when 
specifying a subpool from 128 through 254, 
storage is allocated from the high-address 
portion of the partition. Subpool 255 is 
handled as a special case as described in 
preceding paragraphs. 


For a complete description of main 
storage supervisor functions, see Fixed- 


Task Supervisor, Program Logic Manual. 
TIMER SUPERVISION 
Timer supervision routines are an 


optional feature of MFT. If selected, the 
user may request timer services through the 


TIME, STIMER, and TTIMER macro instruc- 
tions. The TIME service routine (IEAORTOO) 
determines the date and time of day. The 
STIMER service routine (IEAQOST0O0) sets a 
user specified interval, and the TTIMER 
service routine (IEAOST0O0) determines’ the 
amount of time remaining in a previously 
specified interval. Whenever a timer in- 
terval is requested in an STIMER macro 
instruction, a timer queue element (TQE) is 
constructed. These elements are chained 
together in a timer queue. The queue is 
ordered so that the TQE representing the 
next interval to expire is always at the 
top of the queue. When a requested inter- 
val expires, a timer interruption occurs 
and the Supervisor Timer Interruption 
Handling Routine (IEAOTIOO) takes appropri- 
ate action, depending on the type of inter- 
val which has’ expired. If job/step CPU 
timing is included in the system, IEAOTIOO 
adjusts the pseudo timer field in IEFATPC in 
the same manner it adjusts the hardware 
timer. 


TIMING PROCEDURE 


The System/360 interval timer is a 32 
bit word in lower main storage which con- 
tinually decrements as long as the _ system 
is running and the interval timer switch is 
on. The timer supervision routines use 
this hardware timer to accomplish their 


functions. The timer supervision routines 
can set the hardware timer to any interval 
between zero and six hours. An interrup- 


tion occurs when the hardware timer decre- 
ments to zero. Since the hardware timer 
never exceeds six hours, four values are 
needed to maintain elapsed time for a full 
day. These values are: 


Hardware timer 

Six Hour Pseudo Clock (SHPC) 
Twenty-four Hour Pseudo Clock (T4PC) 
Local Time Pseudo Clock (LTPC) 


The SHPC is used to time intervals up to 
six hours; the T4PC is used to time inter- 
vals up to twenty-four hours. The LTPC 
contains the local time of day entered by 
the operator during system initialization. 


When an STIMER macro instruction is 
issued, the STIMER' supervisory routine 
adjusts the time interval requested rela- 
tive to the intervals in the hardware 
timers and pseudo clocks. This enables the 
Supervisory routines to place the newly 
requested timer element in the correct 
place on the timer queue. 


TIMER PSEUDO CLOCK ROUTINE (IEATPC) 
The timer pseudo clock routine (IEATPC) 
contains all variable information that 
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would normally be included in the resident 
timer routines. This information includes: 


e Pseudo clocks 
incrementing CVT 


e Work space used for 
date 


e Accumulator for the job/step CPU timing 
feature 


COMPARISON OF PCP, MFT, AND MVT TIMER 
SUPERVISION 


Requests for timer services in PCP, MFT, 
and MVI are made using the same macro 
instructions. Timer requests are enqueued 
on the timer queue in the same way in all 
three systems. There is one difference 
between PCP and MFT timer supervision. 
Because there is only one partition in PCP, 
the timer completion exit routine receives 
control as soon as a requested task time 
interval expires. When a timer interval 
expires in MFT, the timer completion exit 
routine does not receive control until the 
task which requested the timer interval is 
the highest priority ready task in the 
system. In MVT, the maximum amount of time 
permitted to complete a job step or cata- 
loged procedure may be specified on the 


EXEC card. This facility is not provided 
in MFT. 
For a complete description of timer 


Supervisor, see Fixed-Task Supervisor, Pro- 
gram Logic Manual, and MVT Supervisor Pro- 
gram Logic Manual. 


OVERLAY SUPERVISION 


The routines which supervise loading of 
overlay program segments and assist flow of 
control between segments of the overlay 
program are identical in operation for PCP 
and MFT. A complete description of PCP and 
MFT overlay supervision can be found in 


Fixed-Task Supervisor, Program Logic 


Manual. 


MFT RECORDING/RECOVERY ROUTINES 


Operating System Recording/Recovery rou- 
tines are optional control program routines 
which may be selected during system genera- 
tion. They handle two types of equipment 
malfunctions: 


e Malfunctions of the central processing 
unit (CPU), which cause machine-check 
interruptions. 

e Malfunctions in a channel, which cause 
input/output interruptions. 


34.2 


Operating System Recording/Recovery rou- 
tines are divided into two groups: System 
Environment Recording and Recovery 
Management. 


System Evironment Recording includes: 


e System Environment Recording 0 (SERO, 


described in IBM System/360 Operating 


System: Fixed-Task Supervisor, Program 
Logic Manual, Form Y28-6612. 


e System Environment Recording 1 (SER1), 
also described in the Fixed-Task Super- 
visor PLM. 


Recovery Management includes: 


e Machine-Check Handler (MCH), described 
in IBM stem/360 Operatin System: 


Machine-Check Handler for IBM System/ 


360 Model 65, Program Logic Manual, 
Form Y¥27-7155. 


e Channel-Check Handler (CCH), described 


in IBM System/360 Operatong System: 


Input /output Supervisor, Program Logic 
Manual, Form Y28-6616. 


MACHINE-CHECK ROUTINES 


There are three machine-check routines. 
The recording routines: 
SERO, which records information about 


the error and then places’ the 
system in a wait state. 


SER1, which records information about 
the error and attempts to associ- 
ate the error with a task. If it 


can do this, it abnormally ter- 
Minates the task and allows the 
system to continue operation. 


The recovery routine: 


MCH, which records information about 
the error and attempts complete 
recovery from it, including retry 
of the instruction that caused the 
error. 

For the Model 65, any one of these three 
routines may be selected during system 
generation. For the Model 40, 50, 75, and 


91, either SERO or SER1 may be_ selected. 
If no routine is selected, either SERO or 
SER1 is used by default. The version used 
by default depends on the model (or models) 
specified, and on the size of the system 
(see IBM System/360 Operating System: Sys- 
tem Generation, Form C28-6554). 
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CHANNEL-CHECK ROUTINE 
There is only one channel-check routine: 


CCH, which aids 
errors by: 


recovery from channel 


e Providing channel error information to 
IBM-supplied device dependent error 
recovery procedures (ERP). 


Building a record entry which is later 
written on SYS1.LOGREC by the statist- 
ical data recorder of the I7/0 
supervisor. 


This routine may be selected during system 
generation for the Model 65, 75, and 91 
only. 


SYSTEMS WITHOUT RECORDING/RECOVERY ROUTINES 


When an equipment malfunction (caused by 
a machine/check error Or a_ channel. error) 
occurs on an IBM System/360 model that does 
not have Recording/Recovery routines, the 
computer is placed in a wait state (See 
Figure 110A). If the system is a Model 30, 
the operator may then load the System 
Environment Recording, Editing, and Print- 
ing (SEREP) program. SEREP is a model- 


A CPU Malfunction causes a 
Machine Check Interruption 
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e Figure 10A. Recording/Recovery Routines 


dependent stand-alone diagnostic program. 
It is described in IBM System/360: General 


Programming Considerations, Form yY20-0005. 


ENTRY TO RECODING/RECOVERY ROUTINES 

When a machine-check interruption 
occurs, the machine-check new PSW is 
loaded. This causes control to pass 
directly to the Recording/Recovery routine 
which was selected during system generation 
(see Figure 10A). 


When an I/O interruption occurs because 
of a channel error, the I/O new PSW is 
loaded. This causes control to pass to the 
I/O FLIH and then to the I/O Supervisor. 


If the Channel-Check Handler option was 
not selected during system generation, the 
I/O Supervisor enters the SER Interface 
subroutine (SERRO4) within the I/O Supervi- 
sor. This routine loads the machine-check 
new PSW (See Figure 100A). 


If the Channel-Check Handler was 
selected during system generation, the I/0 
Supervisor enters the Channel-Check Handler 
Interface (SERRO4) within the I/O Supervi- 
sor (see Figure 10A). 
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Input/Output Interruption 
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The primary job management function is 
to prepare job steps for execution and, 
when they have keen executed, to direct the 


disposition of data sets created during 
execution. Prior to step execution, jok 
management: 


e Reads control statements from the input 
job stream 


e Places information contained in the 
statements into a series of tables 


e Analyzes input/output requirements 
e Assigns input/output devices 
e Passes control to the jok step 


Following step execution, job management: 
e Releases main storage space occupied by 
the takles 


e Frees input/output devices assigned tc 
the step 


e Disposes of data sets referred to or 
created during execution 


Job management also performs all pro- 
cessing required for communication between 
the operator and the control program. 
Major components of job management are the 
job scheduler, which introduces each job 
step to the system (job processing), and 
the communications and master scheduler 
tasks, which handle all operator-system 
communication (command processing). 


JOB SCHEDULER FUNCTIONS 


The job scheduler includes three pro- 
grams: the reader/interpreter, the initia- 
tor/terminatcr, and the system output writ- 
er. The functions of the reader/ 
interpreter are similar to the MVT reader; 
additional information can be found in IBM 


System/360 Operating System: MVT Job Man- 


agement, Program Logic Manual, Form Y28- 
6660. 


After all control statements for a job 
have been processed, all initiators that 
are waiting for that job class are _ posted 
and the initiator residing in the highest 
priority partition is given control. The 
MFT initiator is described in this publica- 
tion; for information on allocation and 


termination, refer to IBM System/360 Oper- 


JCB MANAGEMENT 


ating System: MVI Jcb Management, Program 
Logic Manual, Form Y28-6660. 


When the job step has been executed, 
control is returned to the initiator/ 
terminator which perforns data set disposi- 
tions and releases input/output (I/O) re- 
sources. If the entire job is to _ be 
terminated, the terminator enqueues all 
data sets on the appropriate system output 
(SYSOUT) queues. 


When the system output writer receives 
control, it dequeuves a job from an output 
queue, end transcribes the data sets to the 
user-specified output device. (See IBM 


System/360 Operating System: MVT Job Man- 


agement, Program Logic Manual, Form Y28&- 
6660, for further information on the system 


output writer.) 


COMMUNICATIONS TASK FUNCTIONS 


The routines of the communications task 
process the following types of communica- 
tion between the operator and the system: 


e Operator commands, entered through the 
console or through the input stream 


e Write-to-operator (WTO) and write-to- 
Operator with reply (WTOR) macro in- 
structions 


e Interruptions caused when the INTERRUPT 
key is pressed, to switch functions 
from the primary console to an alter- 
nate console 


MASTER SCHEDULER TASK FUNCTIONS 


The master scheduler task handles job 
queue manipulation commands and partition 
definitions. SVC 34 and the master sched- 
uler resident command processor routines 
comprise the master scheduler task. 


JOB MANAGEMENT CONTROL FLOW 


Figure 11 shows the major components’) of 
job management and the generai flow of 
control. 


Control is 
whenever the supervisor 


passed to job management 
finds that there 
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are no program request blocks in the re- automatically by the master scheduler task 
quest block queue. This can occur for two or by the operator), and job processing 
reasons: either the initial program load- begins. 

ing (IPL) procedure has just been com- 


pleted, or a job step has just been Entry to Job Management Following Step 





executed. Execution 
Entry to Job Management Following Initial Following step execution, control is 
Program Loading passed to the step termination routine of - 
the initiator/terminator. If no further 
Following IPL, certain actions must be job steps are to be processed, control is 
taken by the oferator before job processing also passed to the job termination routine 
can begin. Therefore, control passes to of the initiator/terminator. Both routines : 


the communications task which issues a are described in the topic “Initiator/ 
message to the operator instructing him to Terminator." 

enter commands, or to redefine the system. 

If he chooses to redefine the system, MFT job management iS Similar in many 
contreol passes to the master scheduler task respects to MVT job management. However, 
to handle the redefinitions. If the system certain major differences in logic exist. 
is not to be redefined, the initialization These differences are described in two 
commands (a SET command, a START reader ma jor topics. "Command Processing" 
command, a START writer command, and a includes the communications task and master 
START INIT conmand) are issued (either scheduler task. “Job Processing” includes: 


COMMAND COMMAND 


See 


ic | Commands 
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Queue Management 
Reader/Interpreter 
Initiator/Terminator 


System output writer 


References to IBM System/360 Operating 
System: MVT Job Management, Program Logic 


Manual, Form Y28-6660 are made in the 
topics where the logic is the same as in 
MVT. 

Tables and work areas used by MFT, MFT 


e System task control module descriptions, and MFT flowcharts are 
included in the appendixes. 
e System restart 
eTable 1. Initial Responders to Conrmands 

a ee ee ape re a ee ee ee ee ee ea 1 
| Command | Initial Responder | 
| --—------------------------—--------------- $----------------------------------—-------- { 
| CANCEL (active jobs) | Initiator | 
|--——----------—_--------—------------------ }~------------------------—---—--------—------ { 
| CANCEL (job in queue) | Master Scheduler | 
}---------------------------—--------------- }---------------=--------------------------- { 
| DEFINE | Master Scheduler | 
}--—---------------------------------------- }~------------------------------------------ { 
| DISPLAY STATUS | Initiator | 
|------------------------------------------- +------------------------------------------- { 
| DISPLAY JOBNAMES | Initiator l 
}------------------------------------------- }------------------------------—------—----- { 
| DISPLAY A,0,R,N, jobname | Master Scheduler | 
|--— ---------------=----------------------- }------------------------------------------- { 
| DISPLAY T | Timer Maintenance Routine * 
pa a ee ee a ae a ee ee { 
| HALT | Statistics Update Routine * | 
|--—--------------------------------------- }---------------=--------------------------- { 
| HOLD | Master Scheduler | 
}---- --------------------------------------- $------------------------------------------- { 
| MODIFY | Writer | 
iI ka a a RG aa a ae { 
| MOUNT | Master Scheduler | 
| -----------------------—----—-------------- }~------------------------------------------- { 
| RELEASE | Master Scheduler | 
}------------------------------------------- }------------------------------------------- { 
| REPLY | Master Scheduler | 
|--—---------------------------------------- }------------------------------------------- { 
| RESET | Master Scheduler | 
Se a ee a a eae ee ee | 
| SET CLOCK, DATE | Timer Maintenance Routine #* | 
Pe er et ae eae Da ag ee ee | 
| SET PROC, Q, AUTO | Master Scheduler | 
}--—--------------------------------------- }------------------------- ------------------ { 
| START/STOP Reader | Reader/Interpreter | 
pe ee ee Pas eee ae ee ee ee ee { 
| START/STOP Writer | Writer | 
}--— --------------------------------------- $------------------------------------------- { 
| UNLOAD | Initiator | 
}------------------------------------------ aaa a 29 === === === 9-8-2888 { 
| VARY | Initiator | 
}----------------------------------------- 4_-------------------_---------~------------ | 
| * See the publication IBM System/360 Operating System: MVT Supervisor, Program | 
| Logic Manual, Form Y28-6659. | 
Lo a i ee ee ee es ee ee ee J 
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COMMAND PROCESSING 


Operator commands control system opera- 
tion and modify system tasks. Command 
processing in MFT is handled by the commu- 


nications task and the master scheduler 
task. With the exception of DEFINE, com- 
mands can be entered into the syster 
through the console or the input job 
stream. The DEFINE command can be entered 
only through the console. Commands entered 
through the console are read by the commu- 


nications task and routed to the master 
scheduler (see Figure 12). The communica- 
tions task also communicates between the 


syster and the operator; it handles WTO/ 
WTOR macro instructions, assigns message 
identifiers (including partition numbers), 
and maintains reply queue elements. 


When a command is encountered in the 
input stream, the reader/interpreter passes 
control to SVC 34 to process the command. 
Svc 34 processes most commands completely 
and returns control to the interrupted 
routine. For the SET and DEFINE commands, 
which are not processed completely by Svc 
34, control is passed to the master sched- 
uler resident command processor routine. 


Communication Task 
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from the Console 


Master Scheduler Task 







Command is 
Processed 


Appropriate Action is 
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if the Command is Rejected. 


Reader or Writer 
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Operator Stating that 
the Reader or Writer 
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Figure 12. Command Processing Flow 
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The commands accepted and processed by 
MFT are the following: 


CANCEL 
DEFINE 
DISPLAY 
HALT 
HOLD 
MODIFY 
MOUNT 
RELEASE 
REPLY 
RESET 
SET 
START 
STOP 
UNLOAD 
VARY 


The format and syntax of these commands 


can be found in IBM System/360 Operating 
System: Operator's Guide, Form C28-6540. 


COMMUNICATIONS TASK 


The routines that handle operator-system 
communication are contained in the communi- 


cations task. Communication may take 
either of two forms: commands, which allow 
the operator to change the status of the 


system or of a job or job step, and WTO or 
WTOR macro instructions, which allow prob- 
lem programs or system components to issue 
messages to the operator. The communica- 
tions task routines also switch functions 
from the primary console device to an 
alternate console device when the INTERRUPT 
key is pressed. 


WTO/WTOR MACRO INSTRUCTION PROCESSING 


Whenever a WTO or WTOR macro instruction 
is issued, a supervisor call (SVC) inter- 
ruption occurs. The supervisor identifies 
the type of interruption and passes control 


to the communications task to issue mes- 
Sages and/or to read replies. (See Figure 
13.) 


EXTERNAL INTERRUPTION PROCESSING 


When the operator presses the INTERRUPT 
key, an external interruption occurs. The 
communications task then switches from the 
primary console device to the alternate 
console I/O device. (See Figure 14.) 


COMMUNICATIONS TASK MODULES 


(Chart 05) 
interruptions 
entered or 


The communications task 
receives control through 
which occur when commands’ are 
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messages are written. The following para- 
graphs describe the seven major routines of 
the ccmmunications task. 


Censole interruption routine (IEECVCRA): 
notifies the communications task wait rou- 


tine that a console read has been 
requested. 


Commu nications task wait routine (IEE- 
CVCTW): waits for all WTO/WTOR requests 
and console interrupts and calls the commu- 
nications task router routine. 


Communications task router routine (IEE- 
CVCTR): determines the type of request or 
interruption that occurred and passes con- 
trol to the appropriate processing routine. 


Console device processor _ routines (IEE- 
CVPWM) : performs console read and write 


operations and error checking. 


Write-to-operator routine (IEECVWTO): man- 
ages WTO buffers. 


Write-to-operator with reply routine (IEE- 
VWTOR): manages WTOR buffers. 


External interruption routine (IEECVCRX): 
Switches to the alternate console device 
when an external interruption occurs. 
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Interruption Process- 


Cormands are issued through the’ console 
device or the input reader. Before enter- 
ing commands through the console device, 
the operator must cause an I/O interruption 
by pressing the REQUEST key. When he does, 
control is given to the supervisor, which 
recognizes the interruption and passes con- 
trol to the I/O supervisor. The I/O super- 
visor determines that the interruption is 
an attention Signal and passes control to 


the communications task console interrup- 
tion routine in the nucleus. The console 
interruption routine posts the attention 


event control block (ECB) in the unit 
control module (UCM) and sets the attention 
flag in the UCM list entry corresponding to 
the device from which the interruption 
came. Posting of the attention ECB causes 
the communications task wait routine to be 
dispatched. 


The communications task wait routine 
waits on all communication ECBS associated 
with WTO/WTOR. The wait routine issues a 
multiple WAIT macro instruction on a list 
of ECBs contained in the UCM. When one of 
the ECBs is posted, as by attention or 


external interruptions, the wait is satis- 
fied and the communications’ task thus 
becomes ready. When it becomes the active 


task, it issues SVC 72. This SVC includes 
the console communication service routines 
and the router. 


The communications task serves a number 
of purposes. The first segment of SVC 72, 
called the router, distinguishes among 
these purposes and establishes the order of 
response. When a posted ECB is found by 
the router, the router passes control to 
the specified processor routine via an XCTL 
macro instruction. 


The console-device processor routines 
read and write using the EXCP macro 
instruction. The processor routines con- 
Sist of a routine to service external 
interruptions and three device-oriented 
routines: 1052 Printer-Keyboard routine, 
card reader routine, and printer routine. 
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Each of the three console input/output 
processor routines 1S associated with an 
OPEN/CLOSE support routine, which provides 
data management and input/output supervisor 
contrcl blocks. The specified processor 
routine reads the input message into a 
buffer area and calls the master scheduler 
task via an SVC 34. 


The write-to-operator routine moves’ the 
text from the requesting program's area to 
a buffer area within the nucleus and _ posts 
the communication ECB for write-to- 
operator. 


The write-to-operator with reply routine 
generates a message ID, including a _ parti- 
tion identifier, and creates a reply queue 


element (RPQE) to handle the operator's 
reply. 

The external interruption routine, 
residing in the nucleus, switches to an 


alternate console device when the operator 
presses the INTERRUPT key on the console. 


CONSOLE ATTENTION INTERRUPTION ROUTINE 
(TEECVCRA) 


The console attention interruption rou- 
tine (IEECVCRA), operating in privileged 
mode, posts the communications task atten- 
tion ECB to request reading of the console. 
Input /output interruptions are disabled 
without destroying register contents, and 
without macro access to supervisor ser- 
vices. Using the address of the UCB (found 
in register 7), the UCB address is matched 
to a UCM entry. The attention flag for the 
entry is turned on. Control then passes to 
the POST routine, indicating the attention 
ECB in the UCM. The address in register 14 
is used for return to the input/output 
Supervisor (10S). 


COMMUNICATIONS TASK WAIT ROUTINE CIEECVCTW) 


Upon entry from the dispatcher, the 
communications task wait routine (IEECVCTW) 
issues a WAIT (with a count of one) speci- 
fying the list of ECBs whose address is 
contained in the Event Indication List 
(EIL). Thus the communications task can 
respond to a variety of events since the 
posting of any one ECB satisfies the wait. 
The PCST macro instruction issued in the 
console attention interruption routine 
satisfies the wait, causing the TCB to be 
placed on the ready queue. When next 
dispatched, the wait routine issues an SVC 
72 which results in creation of a supervi- 
sor request Llock (SVRB), and fetching of 
the first segment of the console processor 
routines into the system transient area. 
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COMMUNICATIONS TASK ROUTER (IEECVCTR) 


The communications task router 
(IEECVCTR) is the first segment of SVC 72 
brought into the transient area. Because 


the communications task serves a number of 
purposes, and many service requests may be 
pending, the router establishes the order 
of response. The order is: external 
interruption, input/output list completion, 
attention (console interruption), and WTO/ 
WTOR. Multiple attentions are treated in 


order of appearance in the UCM. Multiple 
input/output completions are treated in 
order of first use of the device. The 


router responds to an attention by building 
a parameter list in the SVRB extended save 
area. The parameter list consists of a 
remote XCTL parameter list, the address of 
the appropriate UCM entry, and the address 
of (contents of CVTCUCB) tne UCM. The 
router then passes control to a processor 
routine by issuing an XCTL macro instruc- 
tion to the remote parameter list, using 
the name obtained from the unit control 
block (UCB) entry. The flag signifying the 
request to be serviced by the processor 
routine is turned off by the routine. 
Consequently, processor routines return 
control to the router by issuing an xXcCTL 
Macro instruction to allow the router to 
schedule service for other requests. If no 
requests are pending, the router exits to 
the wait routine uSing the address in 
register 14. 


In addition to distinguishing the output 
request from other requests, the router 
selects the device to which the message is 
to be sent. The router establishes the 
output device by checking UCB entry attri- 
bute indicators. The appropriate entry is 
the first active UCB entry that supports 
WTO. As before, the router builds a remote 
interface for, and passes control to, a 
processor routine via an XCTL macro 
instruction. 


CONSOLE DEVICE PROCESSOR ROUTINES 
(ITEECVPMX, IEECVPMC, IEECVPMP) 


Control flow in a processor routine is 
determined by the setting of flags in the 
router-selected UCM entry. The close flag 
is tested first. If this flag is on, any 
pending input/output activity is suspended 
by issuing a WAIT macro instruction. cCon- 
trol is then passed to an associated OPEN/ 
CLOSE support routine via an XCTL macro 
instruction for release of various’ control 


blocks. If the close flag is off, the busy 
flag is tested to determine input/output 
status. If there is outstanding input/ 


output activity, error checking and buffer 
disposition occur if the activity has been 
posted complete. Otherwise, any attention 
request is temporarily abkandoned(as are 
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output requests), and control returns to 
the router via an XCTL macrce instruction. 
If the busy flag is off, the attention flag 
is tested; if it is on, the status of the 
device is examined. If the device has not 
been opened, control passes to an asso- 
ciated OPEN/CLOSE support routine via an 
XCTL macro instruction to obtain storage 
for a DCB and access-method dependent § con- 
trol blocks, and for execution of the OPEN 
macro instruction. 


When return is made from the OPEN/CLOSE 
Support routine, a response to the atten- 
tion flag is prepared. A fixed buffer in 
the UCB is’ reserved and an access-method 
dependent interface is constructed. Input/ 
output activity is initiated by issuing an 
EXCP macro instruction for a 1052, and by 
issuing a READ macro instruction for a unit 
record device. In no case does the 
processor routine await completion of this 
activity. Control immediately returns to 
the router via an XCTL macro instruction. 


Control flow within the processor rou- 
tine is as described previously up to the 


Foint at which the output request flag is 
tested. If the flag is on, the processor 
routine obtains the address of an output 


buffer from the UCM. The element is not 
removed from the gueue at this time; this 
occurs only on successful completion of 
input/output activity. This preserves a 
means of retrying the message if an exter- 
nal interruption intervenes before the mes- 


sage is successfully presented to the cur- 
rent device. Since output buffers are 
always selected from the top of the queue, 


the initiation of output to an alternate 
device is unaffected by previous attempts 
to present the message to the primary 
device. 


Having selected a buffer, the processor 
routine establishes data management and 
input/output supervisor (IOS) control block 
linkages. The routine then issues an EXCP 
macro instruction for a 1052, or a WRITE 
macro instruction for a printer. Without 
awaiting compietion of the input/output, 
the processor routine returns to the router 
via an XCTL macro instruction. 


WRITE-TO-OPERATOR ROUTINES (IEECVWTO AND 
IEEVWTOR) 


routine (SVC 35) 
on the console 
WTOR macro instruction is 

component programs or 
problem programs. Messages and replies are 
buffered; the period of time between issu- 
ing the message and receiving the reply is 


The write-to-operator 
writes operator messages 
when a WTO or 
issued by system 


available for processing. Issuance of 
either macro instruction causes an SVC 
interruption. When the SVC interruption is 


handled, the supervisor causes the write- 
to-operator routine to be loaded into the 
transient area of the nucleus and passes 
control to it. 


There are two console queues: the buff- 
er queue and the reply queue. The extent 
of both queues is defined by specifying the 
number of buffers at system generation. An 
attempt to exceed this value results in the 
requesting task being placed on a queue to 
wait for service; i.e., the task is placed 
in a wait condition. Each WTO and WTOR 
Macro instruction results in the addition 
of a WTO Queue Element (WOE) to the buffer 
queue; each WTOR results in the addition of 
a Reply Queue Element (RPQE) to the reply 
queue. SVC 35 (IEECVWTO) sets up the 
problem program message. If it is a WTOR, 
the write-to-operator-with-reply routine 
(IEEVWTOR) inserts the message identifica- 


tion (ID) in addition to a partition iden- 
tifier. The same message ID (which the 
operator must use for his reply) is placed 
in the RPQE with other information to 


insure passing the reply, when received, to 
the proper area. WTO messages are always 
written; a WTOR message may be purged 
(removed from the queue) if the issuing 
task terminates while the message is on the 
buffer queue. Therefore, an RPQGE differs 
from a WOE in that it contains the address 
of the issuing task's' TCB. The buffer 
queue is accessed through the entry UCMWTOQ 
in the UCM. 


The reply queue contains RPQEs for 
operator replies to WTOR. Like WTOR ele- 
ments in the buffer queue, RPQES contain a 
TCB address to permit their being purged 
from the queue if the issuing task is 
abnormally terminated. 


For a REPLY (to WTOR), the processor 
issues SVC 34 (see "Master Scheduler 
Task"). The SVC routine determines’) that 


the incoming command is a REPLY, processes 
the reply, posts the user's ECB and 
branches back to the processor. 


EXTERNAL INTERRUPTION ROUTINE (IEECVCRX) 


The external interruption routine 
assigns functions performed by the primary 
console device to an alternate console 
device. When the operator presses’ the 


INTERRUPT key on the console, an external 
interruption occurs and control passes to 
the supervisor. The supervisor identifies 
the interruption and passes control to the 
external interruption routine which 
Switches consoles and returns control to 
the Supervisor. Console functions may 
later be reassigned to the primary console 
device, if the operator causes’ another 
external interruption. 
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MASTER SCHEDULER TASK 





The MFT master scheduler task (MST) 
processes all commands, and initializes 
main storage at system initialization. It 
is composed of the SVC 34 routines and the 
raster scheduler resident command processor 
routines. SVC 34 processes all commands 
directly except HOLD, RELEASE, RESET, CAN- 
CEL (inactive jobs), DISPLAY (A,Q,N, 
jobname) and VCEFINE. SVC 34 calls the 
resident command processor to complete the 
processing of these commands. 


The master scheduler resides in the 
nucleus and operates under control of its 
own TCB. The master scheduler TCB is 
always dispatchable and is of higher 
priority on the TCB queue than the TCBs for 
the partitioned area (the problem program 
area) of storage. Therefore, when a com- 
mand is issued, the master scheduler always 
gains control of the CPU after the communi- 
cations task for processing the command. 


When processing commands, interruptions 
are disabled so that command processing may 
be completed before any other interruptions 
are serviced. Although commands are _ pro- 
cessed when issued, the command may not 
take effect immediately. An example of 
this is the STOP writer command. The 
liaster scheduler marks a command scheduling 
contrcl blcck (CSCB) which is checked by 
the writer between jobs. The command does 
not take effect until the writer completes 
the job it was processing when the command 
was issued. 


SVC 34 FUNCTIONS 


Svc 34 (Chart 06) is called to process 
all commands. AS previously noted, it 
processes some of these commands completely 
and calls the resident command processor to 
process the remaining commands. The com- 
mands processed completely by SVC 34 are: 


START 

STOP 

MODIFY 

CANCEL (active jobs only) 

HALT 

MOUNT 

VARY 

UNLOAD 

REPLY 

DISPLAY (JOBNAMES, T, or STATUS) 


For CANCEL (inactive jobs), HOLD, 
RELEASE, RESET, DISPLAY (A, Q, N, R, job- 
name), and DEFINE commands, SVC 34 does 
preliminary processing before passing con- 
trol to the resident command processor. 
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describe two 
new MFT 


The following paragraphs 
modified MVT routines and two 
routines within SVC 34. 


Validity Check Command Routine (IEE0403D) 


The validity check command routine 
(IEEO4O3D) scans and checks the validity of 
commands for proper syntax and content. 
The buffer is scanned for the first 
Character of the verb. If the verb is 
eight characters or less and properly de- 
limited, it is placed in the verb substi- 
tute of the extended save area. Thena 
check is made for a parameter list. If a 
parameter list is found, its address is put 
in the parameter position of the extended 
save area. If there iS no parameter list, 
zero is placed in tne parameter list posi- 
tion of the extended save area. Next, the 
verb 1S compared against a table of valid 
verbs. If a match iS not found, the 
COMMAND INVALID error message is written. 
If a match is found, the validity check 
routine passes control to the appropriate 
processing module via an XCTL macro 
instruction. 


Reply Processor Routine (IEE1203D) 


The reply processor routine attempts to 
check the validity of the operator's reply 
command by matching the command with an 
cutstanding reply request (RPQE). If 
valid, the reply command is then moved to 
the buffer of the user that issued the 
respective WTOR. Tne RPQE is freed, and 
chain relinkage is performed. The user's 
ECB and RPQE count ECB in the UCM are 
posted. The routine then returns to _ the 
calling routine. 


DEFINE, MOUNT, and CANCEL Routine 
(ITEESD571) 


This routine processes the DEFINE com- 
Mand by setting the necessary indicators in 
the master scheduler resident data area. 


It then posts the ECB for the resident 
command processor. This routine also pro- 
cesses the CANCEL command (for active 


jobs), and the MOUNT command. 


MOUNT processing parallels that of PCP 
by building a parameter list for, and 
issuing an XCTL macro instruction to the 
PCP master command EXCP routine (IGC0103D). 


Cancelling of an active job is handled 
ky scanning the CSCBs for a jobname _ com- 
pare. If the compare is equal and the CSCB 
is marked cancellable, IEESD571 issues a 
BALR to ABTERM with the job's TCB address 
and proper completion code dump indication. 
If the CSCB is not marked cancellable, the 
CSCB is marked canceled and is posted. If 
the job is not found, IEESD571 passes 
control to the CSCB creation routine 





(IEEO803D) via an XCTL macro instruction, 
to CANCEL the jobname on the job queue. 
(See IBM System/360 Operating System: MVT 
Job Management, Program Logic Manual, Form 
¥28-6660, for a description of IEE0803D.) 





START and STOP INIT Command Routine 
(IEEFSCD561) 


This routine processes the START command 


and the STOP INIT command. For a START 
commard, the routine first extracts the 
partition number from the command and 


determines if the partition can accept the 
command; i.e., the routine determines if 
the partition is established aS a reader, 
writer, or problem program, and if it is 
large enough to contain the requested task. 


The routine builds and chains a CSCB, 
passes the address of the CSCB_ to the 
partition's PIB, and posts the partition. 
(See Figure 15.) 

This routine also processes the STOP 
INIT command. After verifying that the 


partition number is correct, the routine 
Marks the partition's PIB to indicate STOP 
INIT. 











START Command 
in Input 
Stream 


START Command 


at Console 


SVC 34 





Check 
Command Route 
Processing 


Communication [(SVC 34) (SVC 34)} Reader/ 


Interpreter 





Build and 
Chain CSCB 





Put CSCB 
in PIB, Post 


"Nlo Work" ECB 





Retum to IOS 


Figure 15. START Command Processing Flow 


SYSTEM INITIALIZATION 


The master scheduler task (Chart 07) 
performs the function of initializing main 
storage. In MVT this is done by NIP. In 
MFT it is done by the master scheduler to 
facilitate redefinition of main storage. 
The following paragraphs describe the 
action of the master scheduler in defining 
Main storage at system initialization. 


The master scheduler task is loaded with 
the nucleus. Its task control block (TCB) 
points to the master scheduler request 
block (RB) in the nucleus. NIP saves’ the 
RB address and the contents of the boundary 
box describing the normal master scheduler 
task partition, for later use by the master 


scheduler initialization routine IEFSD569. 
(Note: IEFSD569 is brought into main 
Storage by the macro instruction SGIEEOVV 


generated during system generation.) 


The boundary box (BBX) is then changed 
by NIP to describe a partition including 
all of storage except the nucleus. The 
address of an RB at the low address of this 
partition is placed in the master scheduler 
TCB. NIP then creates the RB. The RB 
points to an XCTL to IEFSD569. NIP then 
sets the master scheduler task dispatchable 
and branches to the dispatcher. 


The master scheduler initialization rou- 
tine is given control to perform scheduler 
initialization. First it passes control to 
the communications task initialization rou- 
tine (IEECVCTI) via a LINK macro instruc- 
tion. It then uses the communications task 
to request any partition changes. On 
return from the communications task, the 
Master scheduler initialization routine 
passes control to the definition routine, 
IEEDFIN1, via a LINK macro instruction. 
IFEDFIN1 communicates with the operator, or 
prepares the partition as it was described 
at system generation. IEFSD569 then issues 
the READY message, types the automatic 
commands, and issues a WAIT macro instruc-— 
tion. 


When the operator presses the REQUEST 
key, control is given to the supervisor 
which recognizes the interruption and 
passes control to the input/output supervi- 
SOr. The input/output supervisor deter- 
mines that the interruption is an attention 
Signal and passes control to communications 
task console attention interrupt routine 
(described above). The interrupt routine 
posts the communications task attention ECB 
to request reading of the _ console. The 
operator enters a SET command. SVC 34 
posts the WAIT and places the parameters of 
the SET command in the master scheduler 
resident data area. The master scheduler 
initialization routine then regains control 
to continue processing. Control blocks for 
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the job queue and procedure library are 
created. To format the job queue, the 
routine passes control to queue initializa- 
tion routine IEFSD055 via a LINK macro 
instruction which places a queue control 
record (QCR) in the nucleus after the DCB 
and DEB. Control then passes to queue 
Manager formatting routine IEFORMAT which 
formats the job queue and returns control 
to the queue initialization routine. (For 
a discussion of these two modules, see the 
topic “Cueue Manager".) After return from 
the queue manager initialization routine, 
the master scheduler initialization module 
displays and processes any automatic com 
Mands. 


The master scheduler initialization rou- 
tine then establishes partitions based on 
inforration in the TCBs. It constructs an 
RB in each partition, with an XCTL macro 
instruction addressing job selection module 
IEFSD510 (for large partitions), or small 
partition module IEFSD599 (for small parti- 
tions). The master scheduler initializa- 
tion routine then readjusts the pointers to 
the master scheduler area, and returns to 


the dispatcher. The dispatcher returns 
control to the master scheduler task, but 
the TCB now points to master scheduler 


router routine IEECIR5S0O, in the nucleus. 
Master Scheduler Router Routine (IFECIR50) 


Resident naster scheduler router routine 
IEECIR5O waits on an ECB which is frosted by 
SVC 34 when a command has been scheduled 
for processing. This router (Chart 08) 
scans the CSCE chain for any outstanding 
commands to be processed. If a command is 
found, the CSCB iS removed from the chain. 
The router routine then passes control to 
syntax check routine IEESD562 via a LINK 
Macro instruction, passing the address of 
the CSCB. 


After all commands are processed, or if 
none are found, the router routine deter- 
Mines if a DEFINE command has been entered. 
If so, the router routine passes control to 
IEEDFINi, the first module of the defini- 
tion routines, via a LINK macro instruc- 
tion. If no DEFINE command has_ been 
issued, the router routine returns to wait 
on its’ ECB. No test is made for DEFINE 
command scheduling until all other commands 
have keen processed. 


Syntax Check Routine (IEESD562) 


Syntax check routine IEESD562 checks the 
syntax of the command parameter in the CSCB 
(Chart 09). If a search of the input work 
queues (SYS1.SYSJOBQE) is required for pro- 
cessing the command, the syntax check rou- 
tine sets internal codes for the queue 
search, issues a GETMAIN to obtain storage, 
and constructs an event control block (ECB) 


44 


and an input/output block (IOB). Control 
is then passed to queue search setup rou- 
tine IEESD563. If the command was a DIS- 
PLAY A command, control is passed to DIS- 
PLAY A routine IEESD566. If it wasa 
DISPLAY R command, control is passed _ to 
DISPLAY R routine IEESD567. 


Queue Search Setup Routine (IEESD563) 


Queue search setup routine IEESD563 
determines which of the queues is to _ he 
searched and reads the queue control record 
(OCR) for that queue. If the queue must be 
searched, the queue search setup routine 
establishes parameters for the search. The 
queue search setup routine then passes 
control to queue search routine IEESD564 
Via an XCTL macro instruction. When the 
queue search setup routine regains control, 
the QCR is scanned and if any information 
in the record has been changed, the updated 
information is rewritten on SYS1.SYSJOBQE. 
The queue search setup routine then estab- 
lishes a parameter list and passes’ control 
to service routine IEFSD565 via an XCTL 
macro instruction. 


Queue Search Routine (IEESD564) 


Queue search routine IEESD564 reads the 
entries of a queue kased on the parameter 


information passed by setup routine 
IEESD563. If tne command processing 
requires changes in the chaining informa- 
tion in a queue entry or control record, 
the updated information is written on the 
queue. Action indicators are passed as 
parameters when control returns to the 


setup routine. 
Service Routine (IEESD565) 
Based on 


calling routine, service 
performs the follcwing: 


the information passed by the 
routine IFESD565 


1. Passes control to queue manager 
enqueue routine IEFQMNQQ via ae LINK 
macro instruction to engueue an entry 
or OCR. 


Ds Issues a FREEMAIN macro instruction to 
free the ECB/IOB which was used to 
read SYS1.SYSJOBCE. 


3. Passes control to the master scheduler 
message module (IEE0503D) via a LINK 
wacro instruction to write a message. 


After the requested processing nas been 
performed, the service routine transfers 
control to router routine IEECIR50O. 

DISPLAY A Routine (IEESD566) 


DISPLAY A routine IEESD566 receives con- 
trol from syntax check routine IFESD562 
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when the DISPLAY A (active) command is 
entered. This routine constructs WIO mes- 
sages containing the active job and step- 
names. The DISPLAY A routine returns’ con- 
trol to the router routine. 


DISPLAY R Routine (IEEDS567) 


DISPLAY R routine IEESD567 receives con- 
trol from syntax check routine IEESD562 
when the DISPLAY R command is’ entered. 
This routine constructs WTO messages con- 
taining the ID of each unreplied-to WTOR 
message, the unit number of each device for 
which a mount has been requested but not 
complied with, and an indication if an AVR 
mount message is pending. If none of these 
conditions exists, the operator is advised 
that there are no outstanding requests. 
DISPLAY R routine returns control to router 
routine IEECIRSO. 


PARTITION DEFINITION BY THE MASTER 
SCHEDULER 


The master scheduler uses’ the DEFINE 
command processing routines (shown in 
Figure 16) to initialize and change parti- 
tion definitions in MFT. 


DEFINE Command Initialization Routine 
(IEEDFIN1) 


The master scheduler passes control to 
DEFINE command initialization routine IEED- 
FINI whenever a DEFINE command is entered 
by the operator. The routine also receives 
control from the master sheduler during 
system initialization, after the nucleus 
initialization program (NIP) completes its 
preparation of the system. In either case 
the routine builds the DEFINE data area 
containing the size and description (job 
classes A-O, or R or W) of each partition 
If Main Storage Hierarchy Support is 
included in the system, the data area 
contains the size of the partitions in 
terms of hierarchies. Hierarchy 0 repre- 
sents processor storage and hierarchy 1 
represents 2361 Core Storage. 


If the time-slicing feature is included 
in the system, the data area also contains 
a doubleword of time-slicing information, 
including the first and last partition 
numbers in the time-slicing group and the 
time interval (in milliseconds) assigned to 
the group of partitions. This data is used 
at completion of DEFINE processing to 
define the partitioning of main storage. 


initialization 
the result of a 
whether 


If the DEFINE command 
routine was entered as 
DEFINE command, it then determines 
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LIST was specified, and, if so, passes 
control to listing routine IEEDFIN4 via an 
XCTL macro instruction. If not, the rou- 
tine passes control to message routine 
IEEDFIN5S via an XCTL macro instruction. 


If the routine was entered during system 
initialization, it determines whether par- 
tition redefinitions of LIST was’ specified 
by the operator, and, if not, passes con- 
trol to validity check routine IEEDFIN3 via 
an XCTL macro instruction. If either LIST 
or partition redefinitions were specified, 
the routine continues processing as if a 
DEFINE command had been entered by the 
operator. 


Listing Routine (IEEDFIN4) 


Listing routine IEEDFIN4 lists partition 
definitions. If the time-slicing feature 
is in the system, it also lists the time- 
Slicing attributes. After performing the 
listing function, the routine determines 
whether an END keyword has been read _ from 
the console, and, if so, passes control to 
validity check routine IEEDFINI3 via an 
XCTL macro instruction. If not, it passes 
control to message routine IEEDFIN5 via an 
XCTL macro instruction. 


Message Routine (IEEDFIN5) 


The messages issued by message routine 
IEEDFIN5 when entered by other DEFINE pro- 
cessing routines are: 


e IEEDFIN1: The routine issues an ENTER 
DEFINITION message. 
the 


e IEEDFIN2: The routine issues 


appropriate error message. 


e ITEEDFIN3: The routine issues’ the 


appropriate error message. 


e IEEDFING: The routine issues a CON- 
TINUE DEFINITION message. 

e ITEEDFIN6: The routine issues’. the 
appropriate error message. 

e IEEDFIN7: The routine issues’ either 


the appropriate error message or a 
CONTINUE DEFINITION message. 


e IEEDFINS: The routine issues a DEFINI- 
TION COMPLETED message. 


After issuing the message, the routine 
determines whether processing is complete, 
and if so, returns to the dispatcher. If 
not, the routine passes control to syntax 
check routine IEEDFIN2 via an XCTL macro 
instruction. 
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Syntax Check Routine (IEEDFIN2) 


check routine IEEDFIN2 scans the 
operator. Each 


Syntax 
statement entered by the 
entry in the statement -- a partition 
definition, a time-slicing change, or a 
keyword -- is processed separately. 


If the entry is a partition definition, 
the routine checks the entry for syntax 
errors. If a syntax error is found, the 
routine passes control to message routine 
IEFEDFIN5 via an xXCTL macro instruction, 
thus ignoring the erroneous entry and all 
following entries. If the partition 
definition is valid, the routine updates 
the DEFINE data area with the partition 
information, then gets the next entry for 
processing. 


If the entry is a time-slicing change, 
the routine passes control to time-slice 
check routine IEEDFIN6 via an XCTL macro 
instruction. 


If the entry is neither a partition 
definition nor a time-slicing change, the 
routine assumes that it is a keyword and 
passes control to keyword scan _ routine 
IEEDFIN7 via an XCTL macro instruction. 


Time-Slice Syntax Check Routine (IEEDFIN6) 


Time-slice syntax check routine IEEDFIN6 
checks the time-slicing entry for syntax 
errors. If a syntax error is found, the 
routine passes control to message routine 
IEEDFIN5S via an xXCTL macro instruction, 
thus ignoring the erroneous entry and all 
following entries. If the time-slicing 
change is valid, the routine updates’ the 
DEFINE data area with the time-slicing 
information, gets the next entry in the 
statement being processed, and passes con- 
trol to syntax check routine IEEDFIN2 via 
an XCTL macro instruction. 


Keyword Scan Routine (IEEDFIN7) 


Keyword scan routine IEEDFIN7 determines 
whether the entry being processed isa 
valid keyword. If it is not ae valid 
keyword, the routine passes control to 
message routine IEEDFIN5 via an XCTL macro 
instruction, thus ignoring the erroneous 
entry and all following entries. If a 
valid keyword is found, the routine sets 
the appropriate keyword indicator in the 
DEFINE data area. 

If there are more entries to be pro- 
cessed, the routine gets the next entry and 
passes control to syntax check routine 
IEEDFIN2 via an XCTL macro instruction. 


If there are no more entries’ to be 
processed (end of input), the routine 
determines whether a LIST keyword had been 
entered, and, if so, passes control to 


routine IEEDFIN4Y via an XCTL macro 
If LIST was not specified, a 
check for the END keyword is made. If an 
END entry is found, the routine passes 
control to validity check routine IEEDFIN3 
via an XCTL macro instruction; otherwise, 
control is passed via an XCTL macro 
instruction to message routine IEEDFINS. 


listing 
instruction. 


Validity Check Routine (IEEDFIN3) 


Validity check routine IEFDFIN3 makes 
final checks to determine that the informa- 
tion entered by the operator is correct 
(e.g., that no more than 15 problem program 
partitions have been defined). The routine 
then determines the partitions affected and 
constructs a list of ECBs (one for’ each 
affected partition). The address of the 
ECB, which must be posted by the affected 
partition, is placed in the PIB of the 
partition. If time-slicing information was 
changed, the new information is placed in 
the DFTMSL word of the data area, and the 
time-slice control element (TSCE) is 
updated accordingly. (See "Dispatching a 
Task (with Time Slicing)" in the Supervisor 
section for a description of the fTSCE). 
The routine then issues a WAIT macro 
instruction on the ECB list. When the ECB 
list has been posted, the routine passes 
control to system reinitialization routine 
IEEDFIN8 via an XCTL macro instruction. 


If Main Storage Hierarchy Support is 
included in the system, IEEDFIN3 also 
determines whether a partition was defined 
in two segments. If it was, before setting 
the task inactive, IEEDFIN3 determines if 
the operator has reduced both segments of 
the partition to zero. If both segments 
have been reduced to zero, the partition is 
made inactive after the current task ter- 
Minates. The data area is then altered and 
message routine IEEDFIN5 receives’ control 
to issue the DEFINITION COMPLETED message. 


System Reinitialization Routine (IEEDFIN8) 


System reinitialization routine IEEDFIN8 
sets the protection key to zero if the 
System is protected. Using the information 
in the DEFINE data area, the routine builds 
request blocks and boundry boxes for the 
defined partitions and updates the parti- 
tion information blocks. The routine then 
passes control to command final processor 
routine IEEDFIN9S via an XCTL macro 
instruction. 


Command Final Processor (IEEDFIN9) 
Command final processor routine IEEDFIN9 


updates the task control blocks affected by 
time-slicing if time-slicing is specified. 


The routine then passes control to message 
routine IEEDFINS5S via an XCTL macro 
instruction. 
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JOB PROCESSING 


Job processing is accomplished by three 
types of tasks: 


e Reading tasks, which control the read- 
ing of input job streams and the inter- 
preting of control statements in these 
input streams. 


e Initiating tasks, which control the 
initiating of job steps whose control 
Statements have been read and  inter- 


preted. (Terminating procedures are 
also part of initiating tasks.) 

e Writin tasks, which control the 
transferring of system messages and 
user data sets from direct-access 
volumes on which they were written 
initially to some other external 


storage medium. 


These tasks are created in response to 
START commands entered for readers, initia- 
tors, and writers. Whenever a START reader 
or writer command is entered, the resulting 
command processing brings a reader or writ- 
er into the associated partition. Initia 

tors are brought into all scheduler-size 
partitions at system initialization, and 
after a START INIT command has been issued 
following partition redefinition. An 
initiator is also brought into a partition 
that is specified in a STOP INIT command to 
terminate the initiator. 


There may be more than one of each of 
the job processing tasks. Input job 
streams may be read simultaneously from 
three input devices by issuing a START 
reader command for each input stream. Sys- 
tem messages or data sets may be written to 
as many as 36 output devices by issuing a 
START command for each device. Up to 15 
initiating tasks can exist concurrently. 
Each initiating task is created in response 


to a START INIT command issued for a 
specific partition, or a START INIT.ALL 
command. (See IBM System/360 Operating 


System: Operator's Guide, Form C28-6540.) 


Notes: The total 
exceed 52. 


number of tasks may not 





This section is divided into six topics, 


including the three major tasks discussed 
above, and three other areas associated 
with the major tasks: Queue Manager, Sys- 
tem Task Control, and System Restart. 
QUEUE MANAGER 

MFT uses the MVT Queue Manager. How 


ever, to reduce possible interlocks due _ to 
unavailability of requested tracks, the 
assign routine (IEFQASGQ) has been modi- 
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[ SYSJOBQE). 


fied, and a new module (IEFSD572) has been 
added. A table breakup routine (IEFSD514) 
has also been added to subdivide variable 
size tables located in main storage into 
176-byte data records on disk. Descrip 

tions of some MVT modules have also been 
included to provide a more complete 
explanation of the relationship of these 
modules to the entire system. 


WORK QUEUES 
An MFT system contains 54 work queues 
which form the job queue data set (SYS1. 
These 54 work queues are: 
e Free-track queue 
e HOLD queue 
e Remote job entry (RJE) queue 
e 36 output class queues 
e 15 input job class queues 


The job entries are enqueued in priority 
order within each job class on the appro- 


priate job class queue. Jobs are selected 
for processing according to the job class 
designation of the partition requesting 


work. 


QUEVE MANAGEMENT 


Queue Manager is a general term describ- 
ing a group of routines used by various 
system components, such as the reader/ 
interpreter, initiator/terminator, and out- 
put writer. The queue manager performs 
some common functions for all system com- 
ponents. It performs all input/output for 
accessing the job queue data set and keeps 
track of all space on this queue. The 
queue manager assigns space on the job 
queue in logical track increments for con- 
trol blocks, tables, and system messages 
built by the scheduler. When the control 
blocks and tables have been created, the 
reader/interpreter enqueues (ENQs) the job 
using the queue manager. After the job is 
enqueued, the initiator dequeues (DEQs) the 
job for execution when a partition that is 
assigned to service that job class becomes 
available for work. The terminator places 
control information needed by the system 
output writer on the job queve. At job 
termination, the terminator enqueues' the 
output work description. The writer then 
dequeues the output work according to out- 
put class and priority within the class, 
and transcribes it to the appropriate 
device, specified by the user. 


At system generation, the space for the 
job queue data set is allocated. The 


2 
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device 
considered a non-demountable 
dence volume. 


upon which the job queue resides is 
system resi- 


JOB QUEUE INITIALIZATION 


At system initialization, queue initia- 
lization routine IEFSD055 receives control 
from the SET command processor to construct 
a data control block (DCB) in the nucleus, 
and to issue an OPEN macro instruction 
which causes a data event block (DEB) to be 
built for accessing SYS1.SYSJOBQE. It also 
places a queue manager master queue control 
record (master QCR) in the nucleus after 
the DCB and DEB. (See Figure 17 for the 
format of the master QCR.) Control then 
passes to queue formatting routine 
ITEFORMAT. 


The queue formatting routine divides the 
job queue data set into a control record 
area and a logical track area. The control 
record area contains a copy of the master 
QCR, a control record for the free track 
queue, a control record for the HOLD queue, 
a control record for the Remote Job Entry 
(RJE) queue, a control record for each of 
the 36 SYSOUT writer classes, and a control 
record for each of the 15 input work 
queues. (See Figure 18 for the format of 
an input queue control record.) 


16 (10) 


20 (14) 


24 (18) 


28 (1C) 


32 (20) 
Highest 
Priority 


Figure 18. 


Job Queue Control Record (QCR) 

















0 (0) 
8 byte disk address of the Master QCR 
MBBCCHHR 
8 (8) 2 
Displacement of first track 
Reserved of the free queue Reserved 
12 (C) 2 2 
Number of logical tracks in Number of logical tracks in 
the job queve data set the free-track queve 
16 (10) y) 
plumber ef mack: bested Number of tracks reserved for 
for cancelling of job steps Problem P me 
when queue full roblem Program partitions 
20 (14) 
Displacement of last Displacement of first track 
available logical track containing only job queve 
records 
24 (18) 2 
Number of QCRs per Number of job queue records 
physical track per physical track 
28 (1C) 
Number of records per Number of logical tracks 
logical track for each Problem Program 
partition 
32 (20) ce 
Number of QCRs on the gacres : ups peer a 
See al tase lc first track containing only 
job queue records 
36 (24) 


Figure 17. 


Master Queue Control Record 
(Master OCR) Format 


Addresses of last 
LTH of latest 
entry having 
indicated priority. 


Address of ECB for first task requesting work 
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Note: The first position of the job queue 
control record (job QCR) contains zeros if 
no work exists. The job QCR contains a 
minimum of two entries if work exists for 


at least one priority. 


The job class specified by the user (on 
the JOB statement or in a START command) is 


converted by the system to match the 
system-—assigned job class identifiers. The 
user-assigned job class and corresponding 


system job class identifiers are: 


System-assigned 


User-assigned identifier 
job class (hex idecimal) 
A 28 
B 29 
Cc 2A 
D 2B 
E 2c 
F 2D 
G 2E 
H 2F 
I 30 
J 31 
K 32 
L 33 
M 34 
N 35 
Oo 36 
The logical track area length is vari- 
able. Logical tracks are used instead of 


so that the job queue can 
types. Each 
20-byte header 


physical tracks 
reside on different device 
logical track contains a 
record (as shown in Figure i19) which 
includes a pointer to the next track. The 
header record is used to chain all tracks 


of a job together. When the job is 
enqueuved, the header record is used _ to 
chain jobs first-in/first-out (FIFO) 
according to priority. All jobs of the 


same job class are chained together. Fol 

lowing the header record are ae variable 
number of 176-byte data records. The num- 
ber of records per logical track is deter- 
mined at system generation. All tables, 
control blocks, and system messages are in 
176-byte increments. 


At system initialization, all tracks are 
members of the free track queue. The free 
track queue is a list of logical tracks 
available for assignment to work queues. 
As tracks are needed, they are taken from 
the free track queue. When the system is 
finished with tracks, they are returned to 
the free track queue. After system ini- 
tialization, SYS1.SYSJOBQE appears as shown 
in Figure 20. Figure 21 illustrates typic- 
al input and output work queues. Each 
input and output QCR contains the address 
of the last entry in each priority queue. 
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eFigure 19. 


Reserved 
Reserved 


First logical track of the job 


8 (8) 
Reserved Reserved 
12 (C) 2 1 1 
: . Number of " 
Next logical track of the job tacls easel Type 
16 (10) 2 
Reserved 


20 (14) 





Last logical track of the 
next job 


Jobclass of 
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Type: 0 = Free track queve 
1 = HOLD queue 
2 = RJE queue 
3-38 = Output class queves 
39 = Reserved 
40-54 = Input work queues 


Logical Track Header (LTH) 
Record Format 


QUEUE MANAGER MODULES 


As jobs are read into the system, they 
are placed into each job class queue 
according to priority (established by the 
PRTY parameter on the JOB statement). When 
the reader/interpreter reads a job or es- 
tablishes a new queue for an output class, 
it establishes a queue entry. This is done 
by Assign/Start Routine IEFQASGT. 


Assign/Start Routine (IEFQAGST) 


The Assign/Start routine takes the first 
track from the available track pool and 
establishes it as the first track for a 
job. The queue manager parameter area 
(QMPA) is updated accordingly. (See IBM 


System/360 Operating System: MVT Job Man- 
agement, Program Logic Manual, Form Y28- 


6660, for a description of CMPA.) An IOB 
and an ECB are created for subsequent 
input/output operations. The actual 
reserving of tracks is done by the assign 


routine, IEFQASGQ. 


Note: MFT does not support the track- 
stacking facility of MVT. 


Assign Routine (IEFQASGQ) 


The assign routine assigns record space 
on the job queue, and determines whether 
the requested blocks can be assigned to the 
current track. If so, the record addresses 
are placed in the external parameter list 


c 


c 


e Figure 20. 
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Data Records 


of the OQOMPA, and the records-available 
field of the QMPA is decremented to reflect 


this assignment. If additional logical 
tracks must be assigned, this routine 
issues an ENQ macro instruction on the 


Master QCR to prevent concurrent access by 
other tasks. The master QCR is read into 
Main storage. 


The primary user of this assign routine 
is the reader/interpreter, although the 
initiator/terminator also uses it. To pre- 
vent the possibility of the reader/ 
interpreter taking all the space and making 
it impossible for jobs to be initiated or 
terminated, two limit values have been 
added: the number of tracks reserved for 
initiating a job, and the number of tracks 
reserved for terminating a job. 


If logical tracks are available, the 
requested tracks are acquired. The address 


Remote Job 36 
Entry QCR 
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Sample Job Queue (SYS1.SYSJOBQE) Format After Initialization 


of the first available logical track is 
updated and the newly assigned tracks are 
chained to the tracks assigned to the job. 
The master QCR is written to the control 
record area of the job queue data _ set. A 
DEQ macro instruction is issued to make the 
master QCR available to the next user. 


If there are no available logical 
tracks, this routine passes control to the 
queue manager/interpreter interlock routine 
(IEFSD572) which issues a message to the 
operator requesting him to reply ‘WAIT’ or 
*CANCEL'. If the reply is WAIT, control 
returns to this assign routine to wait for 
tracks to become available. When the sys- 
tem component is assigned the requested 
record TTRs, it can read and write records 
on the job queue. The master QCR is 
written, and a DEQ macro instruction is 
issued to make the master QCR available to 
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Figure 21. Input and Output Queue Entries 
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the next user. The record addresses in 
storage and TTR pointers are contained in 
the external parameter list of the QMPA. 
When available space on the job queue 
becomes critical, a warning is sent to the 
requesting task. Logical tracks are 
removed from the pool of available tracks 
and assigned to the job. 


If the reply 1S CANCEL, the interlock 
routine deletes all queue space assigned to 


the job, cancels the job, and returns 
control to the assign routine. Normal 
initiator operation recovers the partition 


for further use. 


Interpreter/Queue Manager Interlock Routine 
(IEFSD572) 


When the reader/interpreter requests 
tracks for the job it is processing, and nce 
Space is availakle, IEFQASGQ passes control 
to interlock routine IEFSD572 to identify 
whether an interlock can occur. If the 
reader is transient, the possibility exists 
that space needed by the reader/interpreter 
can be provided only by the termination 
routines, which must operate in the parti- 
tion that the reader occupies. Because the 
requested space is not available, the rou- 
tine issues a message to the operator 
requesting a reply of ‘WAITS or ‘CANCEL'. 
If the reply is WAIT, this routine returns 
to the assign routine to wait for available 
space. (If the reader requesting space is 
a resident reader, no message is issued, 
and a reply of WAIT is assumed.) 


If the reply is CANCEL, control passes 
to the delete routine (IEFQDELQ) to delete 
all queue space assigned to the job being 
processed (if any space had already been 
assigned). When control returns, the 
interlock routine abnormally terminates the 
job with a job-canceled code of 222. Nor- 
mal initiator operation recovers the parti- 
tion for further use. 


Queue Manager Enqueue Routine (IEFQMNQO) 


After all control blocks for a job have 
been written, the job is eligible for 
Selection by an Initiator. Declaring a job 
ready for selection (enqueuing) is done by 
Queue Manager Enqueue routine IEFOMNQO. 


When an interpreter has completed the 
processing of a job, (all records generated 
by the interpreter have been written on the 
queue), it uses this routine to enqueue the 
job, in priority order, on the appropriate 
job class input work queue. When a job 
completes processing, the terminator uses 
this routine to enqueue output data _ sets, 
in priority order, on the appropriate out- 
put work queues. 


To prevent concurrent updates, this rou- 
tine issues an FNQ macro instruction for 
the queue control record (QCR) of the 
proper queue. When the QCR becomes avail- 
able, it is read into main storage. The 
enqueue routine then places the new queue 


entry after the last entry with the same 
priority as shown in Figure 21. The 
address of the new entry is then placed in 


the track header of the prior entry (main- 
taining a chain), and in the QCR position 
for that priority. The job control table 
(JCT) is written. The updated QCR is 
written on the job queue. A DEQ macro 
instruction is issued making the QCR avail- 
able. Control is then returned to the 
calling routine. 


Dequeue Routine (IEFQMDOQQ) 


In addition to dequeuing a job from the 
input queue for an initiator, the dequeue 
routine (LEFQMDQQ) removes the output data 
from an output queue for processing by a 
system output writer. 


The routine issues an ENQ macro instruc- 
tion on the QCR of the selected queue. 
When the QCR becomes available, the dequeue 
routine reads it into main storage. The 
OCR is examined for a job belonging to the 


same job class as the partition. Upon 
finding a job, this routine adjusts the 
chain. If none is found, the requesting 


task tries the next job class. If no work 
is found on any of the selected queues (up 
to three), the requester places itself ina 
wait state. In the case of an output 
writer, a pointer to the "no work" ECB is 
placed in the QCR. It a pointer already 
exists, the ECB is chained to the last ECB 
waiting for that output class. Then the 
updated OCR iS written and a DEQ macro 


instruction is issued making the OCR 
available. 
Once a job has completed processing, or 


the output writer has written all records 
for a job, the tracks are returned to the 
system. This is known as deleting a= job 
and is handled by the queue nanager delete 


routine IEFQDELOQ. 


Delete Routine (IEFQDELQ) 


The Delete routine first issues an ENQ 
macro instruction on the master QCR of the 
free chain of tracks. After control is 
returned, the record is updated to reflect 
the new available tracks. The prior last 
track of free storage is updated to point 
to the new set of free tracks. After the 
master QCR is updated, it is written and a 
DEQ macro instruction is issued against it. 
The ECB indicating wait-for-space is 
posted. 
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Table Breakup Routine (IEFSD514) 


When a reader must be suspended, the job 
scheduler must prevent the destruction of 
Variable size tables in main storage. To 
do this, it calis the queue manager table 
breakup routine, IEFDS514, (Chart 10) which 
subdivides tables in main storage and 
writes them on disk as 176-byte data rec- 
ords. The data records are written in a 
queue entry related to the caller. The jor 
scheduler calls IEFSD514 to retrieve the 
176-byte data records and to reconstruct 
the tables in main storage. Whether read- 
ing or writing tables, the caller must 
build a parameter list (see Figure 22) and 
place the address of the list in general 
register 1 before calling the TBR. 


When the tables are written initially, 
the TBR parameter list must contain the 
address of a QMPA specifying the queue 
entry into which the tables are to be 
written. The function code field (QMPOP) 


of GMPA must specify a write operation. 
The TBR parameter list must also contain 
tne address, subpool, and size of each 


table to be written. The last word of the 
TBR parameter list must be zero. The TBR 
returns a Head TTR address which locates 
the beginning of the tables on disk. This 
TTR must be saved for subsequent retrieval 
of the tables. 





0 (0) 
Address of QMPA 
4 (4) 
Address of First Record (Head TTR) 
8 (8) 
Address of Table 1 
12 (C) 
Size of Table | 
16 (10) 
Address of Table 2 
20 (14) 
Table 2 
Subpool Size of Table 2 
24 (18) 
Address of Table n 
Size of Table n 
Figure 22. Table Breakup Parameter List 
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The initial write establishes disk data 
records for the tables for the duration of 
the associated queue entry (i.e., until the 
entry is deleted). Therefore, further 
write requests must specify the Head TTR in 
the TBR parameter list. Before issuing a 
write request, the caller must retrieve any 
previously written tables to prevent their 
being overlaid by the new write request. 


If the request is for output of tables, 
(transferring from main storage to direct- 
access device), the Head TTR (passed in the 
parameter list) is used to read the first 
table queue control record (TQCR). If the 
Head TTR iS zero, the assign routine, 
IEFQASGQ, is called to assign space fora 
new TQCR. The TQCR is a 176-byte record 
containing a 4-byte forward-cnain pointer 
and space for 43 TTRs. These spaces are 
filled in as the tables are written, using 
the assign routine to assign the TTRs, and 
the Read/Write routine, IEFCMRAW, to write 
the tables in 176-byte segments. If more 
than 43 records are required to hold the 
tables, a new TQCR is chained to the first, 
and processing continues. The low-order 


byte of the last TTR used in writing the 
tables is set to ‘FF'* (hexadecimal) to 
indicate end-of-tables. After these TTRs 


are assigned, they are used each time the 
table breakup routine is called to write 
tables, as long as the Head TTR is pre- 
served by the caller. 


Once a queue entry has been deleted, a 
caller must issue another initial write 
request (Head TTR is zero in the table 
breakup routine parameter list) to estab- 
lish a new string of table data records. 
IEFSD514 does not free table storage areas. 


In retrieving tables, the TBR parameter 
list must contain the address of an asso- 
Ciated QMPA. The function code (QMPOP) 
field must specify a read operation. The 
TBR pdrameter list must also contain the 
Head TTR address. Sufficient space must be 
allowed for the TBR to return the new main 
storage address of each table, and the 
subpool and size of each table as specified 
when they were written by the TBR. 


If the request is for input (reading 
into storage) of tables, the first TQCR is 
read into storage using the Head TTR passed 
in the parameter list. The first record of 
the first table is read, using the first 
record in the TQCR. This record contains 
the size of the table and the number of the 
desired subpool. IEFSD514 issues a GETMAIN 


specifying the subpool and the amount of 
storage required for the table. The 
remainder of the table is then read into 


the storage obtained, using read/write rou- 
tine IEFQMRAW. Each table specified in the 
parameter list is processed in this manner 
until ‘FF (hexadecimal), indicating end- 
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of-tables, is found. As each table is read 
into wain storage, the parameter list is 
updated with the main storage address of 
that table. When all tables have been 


read, contrcol is returned to the caller. 
The address of the updated parameter list 
is returned in register 1. Tables are 
always written in the same sequence that 
they appear in the TBR parameter list, 
beginning with the Head TTR. They are 


retrieved, totally, in the same sequence; 
they cannot be read selectively. 


READER/ INTERPRETER 


MFT uses the MVT reader/interpreter 
(reader). However, because of job class, 
possible MFT interlocks, and the capability 
of using transient readers, some modifica- 
tions have been made to the MVT modules, 
and six new modules have been added. These 
modifications and additions are described 
below. 


MFT allows as many as three input 
readers to execute concurrently with prob- 
lem programs and writers. Resident readers 
operate in previously defined reader parti- 
tions, and transient readers operate in 
proplem program partitions large enough to 


accommodate them. Input stream data for 
the step being read is transcribed onto 
direct-access storage where it is held 
until execution of the associated job 
begins. Problem programs retrieve this 
data directly from the storage device. 

In MFT there are three types of system 


input readers: 
e Resident reader 
e User-assigned transient reader 
e System-assigned transient reader 


Resident and transient readers may operate 
in the same system, provided no more _ than 
one system-assigned reader is specified, 
and the total number of readers does not 
exceed three. The primary difference 
between the user-assigned and system- 
asSigned transient readers is the manner in 
which the transient reader resumes opera- 
tion after it is suspended. 


RESIDENT READERS 


A resident reader operates in a eparti- 
tion designated as such at system genera- 
tion (by replacing the job class identifier 
with R), or during system initialization or 
partition definition (by specifying RDR for 
the job class identifier). A resident 


reader reads its input stream, enqueuing 
jobs until the input stream reaches end-of- 
file or until it is terminated by a STOP 
command entered for that partition. 


not take 
completely 


Note: The STOP command does 
effect until the current joo is 
read. 





TRANSIENT READERS 


A transient reader operates in a problem 
program partition large enough to accommo- 
date it. A transient reader can be ter- 
Minated by issuing a STOP command or by 
reaching end-of-file, as can the resident 
reader. In addition, a transient reader is 
suspended when a job is enqueued either for 
the partition occupied by the reader, or 
for a small partition. (Note that this is 
possible only when a reader completes read- 
ing an entire job.) 


If a transient reader is started in a 
specific partition by including the parti- 
tion assignment in the START command, it 


always resumes operation in that same _ far- 
tition, and only when that partition be- 
comes free. This type of transient reader 
is referred to as user-assigned. If ‘S* is 
substituted for the partition number in the 
START command, the system assigns the read- 


er tc any available large problem program 
partition. This type of transient reader 


is called system-assigned. 


READER CONTROL FLOW 


After a START command is’ entered to 
activate a reader, master scheduler routine 
IEECIR5O determines if the size of the 
requested partition is large enough, and 
posts the partition. Job selection routine 


IEFSD510 determines that a START command 
has been entered, and passes control to 
system task control (STC) syntax check 


routine IEEVSTAR. The syntax check routine 
validates the syntax of the START command, 
builds job control language tables, and 
retrieves the reader cataloged procedure 
specified in the START command. Control is 
then passed to interface routine IEFSD533 
which sets up an interpreter entrance list 
(NEL) for a reader. It also allocates job 
queue space for a transient reader by 
issuing a dummy WRITE macro instruction. 
Contrcl is then passed to linkage module 
IEFSD537 which issues a LINK macro instruc- 


tion to reader initialization routine 
IEFVH1 to begin reading the input job 
stream (Charts 11-15). 

Each reader is assigned to an input 
device specified in the START command. 
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initialization routine 
receives control, it reads its input stream 
using QSAM, and translates job processing 
information into convenient form for subse- 
quent processing by an initiator and system 
output writer. Each job read in by the 
readers iS converted into tables that are 
placed in the appropriate jok class input 
work queue specified by the CLASS parameter 
on the JOB statement. One input work queue 
exists for each of the fifteen problem 
program job classes (A through O). 


When the reader 


After the reader has completed reading a 
job, control passes to the queue manager 
enqueue routine, IEFQMNQQ, which enqueues 
the jcb on the appropriate input work queue 
according to the PRTY parameter on the JOB 
Statement (see “Queue Management" in this 
section). 


Note: If the reader is 
subroutine by a 


being used as a 
problem program, it does 
not engueue the job on the input work 
queue, but returns control to the problem 
program passing the addresses of the JCT 
constructed for that job, and the GMPA 
associated with that input queue entry. 


If data is encountered in the input 
stream, control is passed to the interpret- 
er CPO routine (IEFVHG) to transcribe the 
data onto direct-access storage for later 
retrieval by the proklem program. If there 
is no space for the data, control passes to 
the interpreter operator message routine 
(IEFSD536) to issue a DISPLAY active conm- 
mand and a WTOR’ message. The operator 
replies with either "WAIT" or "CANCEL". If 
"WAIT" is specified, the reader waits for 
Space to become available. If "CANCEL" is 
specified, the reader is canceled and a 
READER CLOSED message is issued. IEFSD536 
then sets indicators which cause cleanup of 
the current job, and control to be _ passed 
to interpreter termination routine IEFVHN 
to terminate the reader. 


After a reader enqueues each job, con- 
trol passes to the transient-reader suspend 
tests routine (IEFSD532). This routine 
decides whether to 1) terminate the reader, 


2) suspend the reader, or 3) have the 
reader continue reading the job stream. 
(The decision to suspend the reader would 


never be made if the reader is resident.) 
If the reader is to ke terminated, control 
passes to the termination routine (IEFVHN). 


If the reader is to be suspended, control 
passes to the transient reader suspend 
routine (IEFSD530). Otherwise, control 


returns to the job and step enqueue routine 
(IEFVHH) to continue reading the job 
stream. 
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Transient Reader Suspend Routine (IEFSD530) 


When a transient reader is suspended, 
transient reader suspend routine IEESD530 
(Chart 16) writes the tables and work areas 
used by the reader onto the work queue data 
set (SYS1.SYSJOBQE). 


The routine closes the reader and proce- 
dure library. Data needed to restore the 
reader is temporarily saved in the inter- 


preter work area (IWA). The IWA is then 
written to the work queue data set. When a 
user-assigned transient reader is sus- 


pended, the address of the reader space on 
the work queue is placed in the partition 
information block (PIB). When a system- 
assigned transient reader is suspended, the 
address of the IWA is placed in the master 
scheduler resident data area (IEFSD568). 
(See Appendix A for the format of 
IEFSD568. ) The work queue data set is 
later used by transient reader restore 
routine IEESD531 to restore the reader when 
the assigned partition becomes available 
after job termination. “No work" ECBs' for 
problem program partitions are posted (see 
"Job Selection"), and sus pend routine 
IEESD530 returns control to system task 
control. 


Transient Reader Restore Routine (IEFSD531) 


Once a partition is again free for the 
reader, transient reader restore routine 
IFFSD531 (Chart 17) receives control and 
issues a GETMAIN for the IWA, Local Work 
Area (LWA), reader DCB, and procedure 
library DCB. The direct-access device 
address of the IWA is retrieved from the 
PIB if a user-assigned reader is to be 
restored, or from the master scheduler 
resident data area, if a system-assigned 
reader is to be restored. The IWA is’~ then 
read in from the job queue. The TIOT is 
read into storage and the TCB pointer is 
updated; other tables and work areas neces- 


Sary to restore the reader are reset from 
the information saved in the MIWA. The 
reader and procedure library DCBS are 


opened and the reader resumes operation to 


Start reading at the point in the job 
stream where it was suspended. Control is 
then passed to interpreter module IEFVHCB 


to continue reading the job stream. 


INITIATOR/TERMINATOR (SCHEDULER) 


TO provide independent scheduling, 
schedulers operate in any problem program 
partition of sufficient size. A partition 
large enough to accommodate the scheduler 
is referred to as a "large partition." A 
partition not large enough to accommodate 
the scheduler is referred to as a "small 
partition". Within a given large parti- 
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tion, a scheduler operates independently of 
schedulers in other large partitions. 
Because small partitions cannot accommodate 
the scheduler, they rely on large parti- 
tions to perform their initiation, alloca- 
tion, and termination operations. Sched 

uling for small partitions is described in 
"Small Partition Scheduling" in this 
section. 


An MFT initiator (Chart 18) dequeuves a 
job (entry) for its partition based ona 
job class designated for the partition. 
Once dequeued, the job is scheduled accord- 
ing to the information contained in the 
entry. 


During allocation and termination of 
each job step, the allocation and termina- 
tion routines place messages and output 
data set pointer blocks in a specified 
output queue. The queue entry is created 
by the reader/interpreter. (The output 
queue entry becomes input to an output 
writer when the job is completed. ) 


An initiator functions as ae control 
program for the scheduling process, using 
the allocation and termination functions as 
closed subroutines. The MFT initiator is 
composed of the following routines: 


Job Selection 

Small Partition 

Job Initiation 

Data Set Integrity 

Step Initiation 

Problem Program Interface 
Step Deletion 

ENQ/DEQ Purge Routine 
Alternate Step Deletion 
Job Deletion 


JOB SELECTION (IEFSD510) 


The job selection routine (Charts 19-23) 
acts as the control routine for the MFT 
initiator. The routine is brought into all 
large problem program partitions by the 
Master scheduler at system initialization, 
by the job deletion routine when a job has 
terminated, or by system task control when 
a writer has been scheduled for a small 
partition or a reader has been suspended. 


Job selection first waits on a "no work" 
ECB in the PIB. This ECB is posted com- 
plete by the command processing routines, 
the job deletion routine, system task con- 
trol, or the small partition module when a 
small partition needs scheduler services. 


When the "no work" ECB has been posted 
complete, the job selection routine checks 
the PIB to determine if a life-of-task 
(LOT) block exists (see Appendix A for a 


description of the LOT block). If not, it 


creates one for the task. 


Job selection then checks the PIB for a 
small partition information list (SPIL) 
pointer (see Appendix A for a description 
of SPIL). If one exists, scheduling is 
performed for the small partition by pass- 
ing control to IEFSD599. If no SPIL point- 
er exists, the PIB is checked to determine 
if the partition is involved in partition 
redefinition; if so, appropriate action is 
taken to inhibit scheduling in the parti- 
tion. (See “Master Scheduler Task". ) 


If the partition in which the initiator 
is operating is not part of a partition 
redefinition, a test is made to determine 
if a reader or writer (system tasks) is to 
be started in the partition. If a reader 
or writer is to be started, control passes 


to system task control which initiates 
readers and writers. 
If no small partition is requesting 


service, no reader or writer is to be 
started, and the partition is not part of a 
redefinition operation, a final check is 
made to determine if a START INIT command 
has been issued; if so, job selection 
attempts to dequeue work from the input 
work queue (see Figure 23). If a STOP INIT 
command has been issued, the attempt to 
dequeue a job is bypassed. 


A threshold check is then made to deter- 
mine if enough logical tracks are available 
on SYS1.SYSJOBQE to start the initiator. 
If not, a START INIT REJECTED message is 
sent to the operator and job selection 
again waits on the "no work" ECB. 


The job selection routine obtains 
storage for the job control table (JCT) and 
then uses the queue manager dequeue routine 
(IEFQOMDQQ) to obtain work from one of the 
input job queues according to the job class 
assignment of the partition. If work is 
found, IEFQMDQQ constructs a CSCB for the 
job and an IOB to be used when reading or 
writing the input queue. The cCSCB is 
constructed in the system queue area and 
the address of the CSCB is placed in the 
LcT. The address of the IOB is placed in 
QMGR1 When a user accounting routine is 
supplied, the job selection routine sets 
the LCT fields LCTTMWRK and LCTTMWRK+4 to 
zero. These fields are used in calculating 
the execution time of a job step. Job 
selection then branches to job initiation 
routine IEFSD511. 


If the search for work for the partition 
is unsuccessful (i.e., no work has’_ been 
enqueued for any of the job classes 
assigned to the partition) tests are made 
to determine if a transient reader is to be 
restored in the partition or if a START 
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command has been entered for a esystem- 
assigned transient reader. If so, system 
task control is called. If a reader is to 
be restored in the partition, job selection 
passes control to special entry point 


IEE534SD in system task control. 


START 
INIT 






JOB 
SELECTION 









ALLOCATION/ 
PROBLEM 
PROGRAM 
INTERFACE 


a ALLOCATION 









Allocation Error | 








PROBLEM 
PROGRAM 





cf TERMINATION 







Step Deletion 





Job Deletion 


Figure 23. Scheduling a Problem Program in 


a Large Partition 


Command Processing Services 


In response to system commands entered 
in the input stream or from the console, 
the command processing routines request a 
service by storing information in the PIB 
of the affected partition or in the master 
scheduler resident data area for START and 
STOP commands issued for system-assigned 
transient readers and writers. The job 
selection routine recognizes these requests 
and takes one of the following actions: 


e Inhibits further job scheduling for the 
partition in preparation for the pro- 
cessing of a DEFINE command. (The 
DEFINE command can be entered only from 
the console.) 


e Prevents execution of problem programs 


in large partitions in response to a 
STOP INIT command. 
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e Passes control to system task control 
in response to a START reader or START 
writer command. 


e Schedules problem program execution in 
response to a START INIT command. 


SMALL PARTITION SCHEDULING 


A partition is defined as “small" when 
its size is at least 8K bytes but less than 


the job scheduler (30K or 44K) generated 
for the system. Small partition scheduling 
is performed by an initiator in a 


scheduler-size partition at the request of 
small partition module IEFSD599 (IEFSD599 
is described later in the topic “Small 
Partition Module"). The small partition is 
therefore temporarily dependent on a large 
partition while scheduler’ services are 
being performed. Scheduling for a small 
partition is independent of scheduling for 
other small partitions in the system. 


The small partition module interfaces 
with job selection module IEFSD510 to 
schedule a problem program, or with system 
task control to schedule a writer in a 
small partition. Communication between the 
small partition module and job selection or 
system task control is maintained through a 
small partition information list (SPIL). 
(The format of a SPIL is shown in Appendix 
A.) 


Small partition module IEFSD599 requests 
the scheduling function by placing the 
address of a SPIL in the partition informa- 
tion block (PIB) of each’ scheduler-size 
partition in the system. Each time job 
selection is entered between jobs, the PIB 
is checked for a non-zero SPIL address. If 
the PIB contains a valid address, the SPIL 
is analyzed, the job class queues for small 
partitions are searched for work, and con- 
trol is passed to one of the following: 


e Job Initiation (IEFSD511), if work has 
been found for a small partition. 


e Step Deletion (IEFSD515), if a small 
partition is waiting for termination. 


(IEEVSTAR), if a 
in the small 


e System Task Control 
writer is to be started 
partition. 


These routines perform the requested 
service in the large partition and use the 
SPIL to indicate their action to IEFSD599. 
When the requested service has been per- 
formed, these routines return to IEFSD510.- 


@ 
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Initiating a Problem Program 


As shown in Figure 24, initiation of a 
problem prograr in a small partition is 
performed by a large partition. If a small 
partition is waiting for work, job selec- 
tion module IEFSD510 dequeues a job from an 
input work queue that the small partition 
is assigned to service. The large parti- 
tion posts a completion code in field ECBA 
of the SPIL when initiation services have 
been performed. 


A completion code of one indicates that 
no work was found for the small partition. 
The small partition then waits on the ECB 
list in the SPIL. The posting of any of 
the listed ECBs causes the small partition 
to request initiation services. 


A completion code of zero indicates that 
initiation services have been performed and 
the problem program job step is ready to be 
executed. The small partition, using the 
allocate parameter list (APL), moves the 
task input/output table (TIOT) and life-of- 
task (LOT) block from the large partition, 
opens required DCBs, and establishes prob- 
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Figure 24. 


lem program mode. (If the system has the 


storage protection feature, the protection 
key is set.) If the job has not been 
canceled, control passes to the problem 


program, thus freeing the large partition 


to continue processing. 


Initiating a Writer 


As shown in Figure 25, if a writer is to 
be started in the small partition, small 
partition module IEFSD599 requests initia- 
tion of the writer by system task control. 
A large partition responds to the request 
by bringing system task control routine 
IEEVSTAR into the large partition. IEE- 
VSTAR initiates the small partition to the 
point of calling in the writer. IEEVSTAR 


then posts ECBA in the SPIL with a comple- 
tion code of zero to indicate to IEFSD599 
that initiation services have been per- 


formed, and the writer is ready to be 
executed. Small partition module IEFSD599, 
using the link parameter list (LPL), moves 
the TIOT from the large partition to the 
small partition. ECBC in the SPIL is 
posted, thus freeing the large partition to 
continue normal processing. Problem pro- 
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gram mode is_ estaklished, the SPIL is 
freed, and control passes to the writer via 
an XCTL macro instruction. 


Terminating the Small Partition 


When the job step is completed, or a 
writer is stopped, small partition module 
IEFSD599 is brought back into the partition 
and entered at special entry point SMALLGO. 
A check is made to determine whether a 
scheduler ABEND occurred. If it did, a 
message is issued to the operator with a 
completion code, and all CSCBs associated 
with that job are removed from the CSCB 
chain. Control then passes to the normal 
entry point of IEFSD599. If no scheduler 
ABEND occurred, the SPIL is created, anda 
Status bit is set indicating that termina- 
tion services are requested. The small 
partition module then begins a search for a 
large partition to perform the job termina- 
tion services or writer end-of-job 
processing. 


After an initiator ina large partition 
has performed the termination services, 
ECBA in the SPIL is posted with a comple- 
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tion code of two to indicate that job 
termination has taken place. A check is 
made to determine if the small partition is 
involved ina redefinition operation. If 
it is, the small partition is made quies- 
cent. If the small partition is not asso- 
ciated with a redefinition operation, it 
requests additional services from an 
initiator ina large partition. 


Note: If the initiator ina large parti- 
tion performs step termination instead of 
job termination, the next step of the job 
in the small partition is scheduled before 
the initiator schedules a job into its 
partition, or before it performs scheduling 
services for another small partition. 


Small Partition Module (IEFSD599) 


Small partition module IEFSD599 (Charts 
24-27) is entered at special entry point 
SMALLGO from either the master scheduler or 
redefinition routines (at system initiali- 
zation), or the ABEND routines (when a step 
has completed execution). IEFSD599 first 
waits on a “no work" ECB located in the 
partition's PIB. When this ECB is posted 
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complete, the PIB is checked to determine 
if a SPIL has been created. If not, one is 
created and an indicator is set in the PIB. 
The PIB is checked to determine if the 
partition is involved in a redefinition 


operation. If so, assigned tracks are 
deleted, the SPIL is freed, and pending 
CSCBS are freed. The ‘DEFINE* ECB in the 


PIB is posted to indicate that the parti- 
tion has been made quiescent, and a return 
is made to wait on the "no work" ECE. 


If no redefinition operation is pending, 
the PIB is checked to determine if a writer 
is to be started in the partition. If so, 
an indicator is set in the SPIL, assigned 
tracks are deleted, and a request for 
scheduling is made to a large partition 
(described below). If a writer is not to 
be started, the STOP INIT bit in the PIB is 
checked. If this bit is on, assigned 
tracks are deleted, the SPIL is freed, and 
a return is made to wait on the ‘no work‘ 
ECB. If the STOP INIT bit is not on, the 
PIB is checked for track assignment. If 
needed, tracks are assigned and indicated 
in the PIB. The SPIL is updated to indi- 
cate a request for initiation of a_ problem 
program. 


A request is made for a large partition 
to service the small partition based on the 
contents of the SPIL. First, an exclusive 
ENQ macro instruction is issued to prevent 
concurrent service requests by small parti- 
tions. Interruptions are disabled to pre- 
vent interference with the address of the 
SPIL in the large partition's PIB. 
IEFSD599 then searches for a scheduler-size 
partition. The TCBs are tested for problem 
program status; when a scheduler-size par- 
tition is found, a determination is made of 
whether the small partition is involved in 
a DEFINE operation. 


If the small partition is involved ina 
DEFINE operation, the test for the large 
partition involved in a DEFINE operation is 
bypassed. If the small partition is not 
involved in a DEFINE operation, the large 
partition is tested to determine if it is 
involved in a DEFINE operation. If so, the 
large partition is bypassed and the MTCB 
search is continued. 


The address of the SPIL is stored in the 
PIB of the large partition, thus constitut- 
ing a request. An indication is made when 
storing occurs. If a large partition is 
waiting on its "no work’ ECB (in its PIB), 
SPIL addresses are cleared in all other 
large partition PIBs, and the large parti- 
tion is posted. When a large partition is 
posted, or all applicable TCBs are checked, 
interruptions are enabled. 


If no SPIL pointers were stored during 
the search, a DEQ macro instruction is 


issued (to allow other small partitions to 
make requests), and a WAIT macro instruc- 
tion is issued ona ‘dormant" ECB in the 
small partition's PIB. (When later posted 


by the command processing routines, the 
small partition module will repeat its 
search). If at least one SPIL pointer was 


stored, a WAIT macro instruction is issued 
on ECBB in the SPIL. This allows a large 
partition, immediately upon recognition of 
the request, to post the ECB complete. The 
small partition module may then issue a DEQ 
macro instruction to release the SPIL 
pointer field so other small partitions may 
make requests. 


Next, a WAIT macro instruction is issued 
on ECBA (in the SPIL) to delay the small 
partition until the requested service has 
been performed. When ECBA is posted com- 
plete by the large partition, the comrple- 
tion code is tested to determine the action 
which occurred. If the completion code is 
two, job termination occurred and return is 
made to the point of determining the DEFINE 
Status of the small partition. If the 
completion code is one, ‘no work’ was found 
for the small partition and ae return is 
made to WAIT on the ECB list in the SPIL. 
If the completion code is zero, the large 
partition is at the point of calling either 
the problem program or a writer. The large 
partition is waiting on ECBC (in the SPIL) 
to allow transfer of information into the 
small partition by the small partition 
module. 


If a problem program is to be initiated, 
IEFSD599 uses the allocate parameter list 
(APL) to move the TIOT and user parameter 
area into the small partition. It then 
posts ECBC (freeing the large partition), 
and opens Fetch and/or JOBLIB ODCBs_ if 
required. The partition is established in 
problem program protection mode. The SPIL 
is freed. 


A check is made to determine if the job 
has been canceled. If so, an ABEND macro 
instruction is issued. If the job has not 
been canceled, an XCTL macro instruction is 
issued to call the problem program into the 
small partition (the problem program passes 
control to ABEND at completion of its 
execution). 


ABEND recalls small partition module and 
enters at special entry point SMALLGO. The 
small partition protection key is changed 
to zero and a SPIL is created. A termina- 
tion request is indicated in the SPIL, and 
IEFSD599 begins the search for a large 
partition to service the request. 


If a writer is to be initiated, the 


control flow is the same as described above 
in "Initiating a Writer". 


Initiator/Terminator 61 


INITIATOR/TERMINATOR CONTROL FLOW 


In addition to IEFSD510 and _ MIEFSD599, 
several other initiator routines are unique 
to MFT. These are described in the follow- 
ing paragraphs. Included also are the MVT 
modules that have been modified by MFT. 
Descriptions of the MVT allocation and step 
initiation routine then passes control to 
termination modules that have not been 
modified by MFT can be found in IBM System/ 


360 Operating System: MVT Job Management, 
Program Logic Manual, Form Y28-6660. 


Job Initiation Routine (IEFSD511) 


Job initiation routine IEFSD511 issues a 
GETMAIN specifying subpool 0 to obtain 
space for the system output class directory 
(SCD). The SCD is then read into the area 
and the contents of the SCD are used to 
initialize QMGR2 in the LOT block. (QMGR2 
13 the queue manager parameter area which 
is used for referencing the output data 
set.) After QOMGR2 has been initialized, 
the storage obtained for the SCD is freed. 
A GETMAIN is then issued to obtain storage 
for IOB2, the IOB used in conjunction with 
QMGR2. A GETMAIN is issued (specifying 
subpool 253) to obtain space for the step 
control table (SCT). The SCT is read into 
the area thus’ obtained. Job initiation 
then branches to data set integrity routine 
IEFSD541. 


Data Set Integrity Routine (IEFSD541) 


The data set integrity routine is 
entered only once per job, from job initia- 
tion routine IEFSD511. It first determines 
whether data set integrity processing is 
required. 


If the JCT indicates a ‘failed‘ job or 
if there are no explicit data sets (DSNAME 
parameter ina DD statement) for the job, 
processing is Lypassed and exit is made to 
step initiation routine IEFSD512. If data 
set integrity processing is required, the 
DSENQ table records are read from the job's 
entry in the input job queue (SYS1. 
SYSJOBQE). Duplicate DSNAMES are elimi- 
nated from the table and each unique DSNAME 
is placed in a minor name list. The most 
restrictive attribute (exclusive or share) 
is chosen for each DSNAME placed in the 
Minor name list. After this processing is 
complete, an ENQ supervisor list is  con- 
structed which contains an entry for each 
DSNAME in the minor name list. Each entry 
is initialized with the following: 


® RET=TEST option of ENQ 
e SYSTEM option of ENO 


e Attribute (E/S) 


DSNAME 


of the corresponding 
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e Address of the common ma jor name 
*SYSDSN* 
e Address of the corresponding DSNAME 


(considered the minor name) in the 


minor name list 


The DSNAME (minor name) length is contained 
in the first byte of each DSNAME field in 
the minor name list. 


When the ENQ supervisor list is_ con- 
structed, the system is disabled and an ENQ 
supervisor call is issued against the list 
to test the availability of the DSNAMEs. 
If the DSNAMES are available, the ENQ 
supervisor list is updated so that each 
entry reflects the RET=NONE option of ENQ. 
A second ENQ supervisor call is issued 
against the list to reserve DSNAMEs for the 
job. The system is enabled and exit is 
Made to step initiation routine IEFSD512. 


If the DSNAMES are unavailable for the 
job (already reserved witn conflicting 
attributes by other task(s) in the system), 
the operator is notified of the condition. 
In notifying the operator, the return code 
field of each entry in the ENQ supervisor 
list is tested for a non-zero setting. If 
the setting iS non-zero, the associated 
DSNAME (minor name) is identified to the 
given the following reply options: 


e RETRY, in case the resources have’ been 
freed by the other task(s) (processing 
is delayed until the operator replies) 


e CANCEL the job. 


If RETRY is entered by the operator, pro- 
cessing continues at the initial ENQ super- 
visor call to again test the availability 
of the DSNAMEs. The operator iS again 
notified, and he can reply either RETRY or 
CANCEL. If the job is canceled by the 
operator, the ‘job fail‘ bit in the JCT is 
set and exit is made to step initiation 
routine IEFSD512. 


Step Initiation Routine (IEFSD512) 


Step initiation routine IEFSD512 first 
issues a GETMAIN specifying subpool 253 to 
obtain storage for an allocate register 
Save area (ARSA) and an allocate parameter 
list (APL). The APL (Figure 26) is ini- 
tialized conteining addresses of the LOT, 
JCT, and SCT, and two words of zeros. The 
step initiation routine then passes control 
to allocation via a LINK macro instruction. 
Allocation returns the addresses of a_ task 
input/output table (TIOT) list (which 
points to the TIOT) in the first word of 
zeros in the APL. On return from alloca- 
tion, the return code is tested to deter- 
Itine if allocation was successful. If not, 
step initiation branches to alternate step 
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Figure 26. Allocate/Terminate Parameter 


List 


deletion routine IEFSD516 via an XCTL macro 
instruction. If allocation was successful, 
the ARSA is freed, and the "step started" 
bit in the SCT is turned on. The address 
of the job's CSCB is stored in the APL (in 
the last word of the list). 


Step initiation then uses queue manager 
read/write routine IEFQMRAW to write the 
JCT and SCT back on the input queue. The 
Gdisk addresses of the JCT and SCT are saved 
in the LCT. A GETMAIN specifying subpool 
253 is issued for the table breakup routine 
(TBR) parameter list and register save 
area. The TBR parameter list is initial- 
ized with the address, size, and subpool 
specifications for the TIOT and LOT block. 
The TIOT and LOT are then written into the 
job's entry in the job queue, and the Head 
TTR is saved in the JCT. The storage 
obtained for the TBR parameter list and 
register save area, I0OB1, and I0OB2 is 
freed. The JCT is then written out. Step 
initiation then passes control to problem 
program interface routine IEFSD513 via an 
XCTL macro instruction. 


Problem Program Interface Routine 
(IEFSD513) 


The problem program interface routine 
prepares the partition for execution of the 
job step. A test is made to determine if 
scheduling was performed for a small parti- 
tion. If so, the address of the APL is 
placed in the SPIL, ECBA in the SPIL is 
posted to indicate that scheduling is com- 
plete, and a WAIT is issued on ECEC. This 
WAIT allows the small partition module to 
copy tables and work areas into the small 


partition. When the tables have been 
copied, ECBC is posted complete, and the 
interface routine frees all storage 


obtained for tables and work areas 
for the LOT block, which is retained. 


except 
The 


address of the LOT block is placed in 
register 1 and this routine passes control 
to job selection, IEFSD510, via an xXCTL 
macro instruction. 


If scheduling was not performed for a 
small partition, a test is made to deter- 
mine if the job has been canceled. If so, 
exit is made by issuing an ABEND macro 
instruction. 


If the job has not been canceled, the 
LOT block is freed, the TIOT is moved to 
the lowest possible location (subpool 0) in 
the partition, and a GETMAIN macro instruc- 
tion specifying subpool 253 is issued for 
the user's parameter list (UPL). The UPL 
(Figure 27) is initialized from the SCT. 
Another GETMAIN macro instruction (subpool 


253) is issued to create a register save 
area for the user's problem program. If 
STEPLIB, JOBLIB, and/or FETCH have been 


specified, their DCBs are created (but not 
opened) in subpool 253. The JCT, SCT, and 
APL are now freed, the STEPLIB or JOBLIB 
and FETCH DCBs are opened, and the TIOT is 
then moved to subpool 253. A single DCB is 
used for STEPLIB or JOBLIB, with STEPLIB 
overriding JOBLIB if both are present. 


Note: The use of subpools, and the order 
in which control blocks and tables are 
created, moved, or deleted, follows a par- 
ticular sequence even though this handling 
occurs within different modules. This is 
done to prevent fragmenting main storage 
within the partition. 


After the TIOT has been moved to the 
highest available position within the par- 
tition, the task control block (TCB) is 
updated and the problem program's protec- 
tion key is set (if the system has storage 
protection). The problem program interface 
routine then passes control to the problem 
program via an XCTL macro instruction. 


0 
l 3 
Address of length field 
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Length of PARM values 


PARM values 
(from EXEC statement) 


(Maximum length = 40 bytes) 





Figure 27. User‘s Parameter List 
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Step Deletion Routine (TEFSD515) 


IEFSD515 is 
execution to 


routine 
step 


Step deletion 
entered at the end of 


prepare the partition for continued execu- 
tion of the job, to interface with the 
termination subroutine, to prepare for the 


initiation of the next step, or to branch 
to job deletion if there are no more steps 
in the current job. When step deletion is 
entered, a check is made to determine 
whether the routine was entered due to an 
ABEND with the scheduler in control. If 
SO, a message is issued to the operator and 
all CSCBs are removed from the CSCB' chain. 
Control passes to IEFSD510. 


If an ABEND did not occur, the step 
deletion routine branches to ENQ/DEQ purge 
routine IEFSD598 via a BALR instruction to 
remove any control bDlocks which were 
engueued, but not dequeued, by the problem 
program step. 


Step deletion then issues a= series of 


GETMAIN requests to obtain storage for 
queue manager IOBs (IOB1l and I0OB2), a 
temporary QMPA, and a register save area 
and parameter list for the table breakup 


These blocks and tables are ini- 
step deletion branches’ to 
queue manager table breakup routine 
TEFSD514, to read in the TIOT and LOT 
blocks for the job step. The addresses in 
these blocks are restored and the storage 
obtained for the temporary work areas is 
freed. 


routine. 
tialized and 


A GETMAIN (subpool 253) is issued to 


obtain storage for the SCT and JCT. The 
SCT is read into storage from the job 
queue, the JCT from its temporary area. 


Storage is obtained for a terminate regis- 
ter save area and a terminate parameter 
list. The terminate parameter list is 
initialized with addresses of control 
blocks (LOT, JCT, SCT, and TIOT list) and 
the step deletion routine branches to the 
termination subroutine via a BALR instruc- 
tion. When termination returns control, 
step deletion frees the terminate register 
Save area and terminate parameter list and 
then checks the return code. 


If the return code indicates that job 
termination was entered, step deletion 
branches to job deletion routine IEFSD517. 


If job termination was not entered, the SCT 
for the next step of the job is read from 
the job queue, and step deletion passes 
control to IEFSD512 via an xXCTL macro 





instruction. 

Note: If a small partition is requesting 
termination, entry to the step deletion 
routine is made at special entry point 
SMALTERM. Entry at this point causes 


pointers to the SPIL and the small parti- 
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tion's TCB to be established before the 
step deletion routine invokes ENQ/DEQ Purge 
routine IEFSD598. 


ENC/DEQ Purge Routine (IEFSD598) 


At job termination, this routine purges 
all ENQ/DEQ control blocks associated with 
the TCB address passed in Register 4 by the 
caller. If step termination was completed 
instead, this routine purges all ENQ/DEQ 
control blocks except the data set integri- 
ty blocks associated with the major name 
SYSDSN. 


When a given resource is dequeued for 
the subject TCB, a task Switch may occur 
for a higher priority requestor whose wait 
count becomes zero, due to availability of 
the resource. (This purge routine operates 
in a disabled state to prevent concurrent 
updating of the ENQ/DEQ control blocks.) 


Alternate Step Deletion Routine (IEFSD516) 


Alternate step deletion routine IEFSD516 
is entered from step initiation routine 
IEFSD512 when allocation for a step has not 
been successful. Using the APL and ARSA 
(created by the step initiation routine) as 
the terminate parameter list and terminate 
register save area, this routine branches 
to termination subroutine IEFSD220 via a 
BALR macro instruction. When control is 
returned from termination, the storage used 


for the parameter list and register save 
area is freed and a test is made to 
determine if job termination was’ entered. 


If so, this routine branches to job dele- 
tion routine IEFSD517. If job termination 
was not entered, the SCT for the next job 
step is read from the job queue and this 
routine branches to step initiation routine 
IEFSD512. 


Job Deletion Routine (IEFSD517) 


The job deletion routine is called at 
job termination to delete the job from the 
input queue and to prepare the partition 
for initiation of the next job. The rou- 
tine sets the high-order byte of the 
LCTTCBAD field of the LCT to ‘80° (hexadec- 
imal) to indicate to the ENQ/DEQ purge 
routine that it is job termination instead 
of step termination. The routine then 
branches to ENQ/DEQ purge routine IEFSD598 
to purge the control blocks. On return 
from the purge routine, the high-order byte 
is reset to ‘OQ0O*. 


routine then deletes 
the job from the input queue, using queue 
manager delete routine IEFQDELQ. All areas 
of storage in the partition which were used 
for the jok (except the LOT block) are 
freed, and the job‘s CSCB is’ freed by 
issuing an SVC 34. The PIB fields used for 


The job deletion 


» | 


the disk address of the TIOT and the LOT 
block are set to zero. If termination was 
for a small partition, ECBA in the SPIL is 
posted with a code of two (indicating job 
termination for the small partition). If 
termination was for a large partiticn (or 


after ECBA has been posted) the “no work" 
ECB in the PIB is posted and the jok 
deletion routine Eranches to job selection 


routine IEFSD510. 


SYSTEM OUTPUT WRITERS 

MFT uses the MVT system output writer 
(Charts 28-29) with minor changes to five 
of the modules. AS in MVT, the user may 
have up to 36 system output writers operat- 
ing concurrently in the system. Each out- 
put writer can handle eight output classes; 
output classes may be shared by writers. 
However, in MFT, system output writers are 
classified as either resident or non- 
resident. A resident writer operates in 
its own partiticn. A non-reSident writer 
operates in any proolem program partition 
large enough tc accommodate it. 


RESIDENT WRITERS 


Resident cutput writer partitions are 
designated in the partition information 
block (PIB) pointer to the TCB by setting 
bits one and two of the first byte to ‘10°. 
This designation is made at system genera- 
tion ky assigning W to the partition in 
place of the jok class or Ly redefining a 
partition and assigning WTR to it. 


A resident writer is activated by issu- 
ing a START command specifying a partition 
designated previously aS a writer parti- 
tion. A resident writer can be terminated 
only ky issuing a STOP command specifying 
the device assigned to that writer. 


NON-RESIDENT WRITERS 


A non-resident system output writer may 


be started ina problem program partition 
large enough to hold the writer by issuing 
a START command specifying either that 
partition or [Ly replacing the partition 
number with an "S* to specify a system- 
asSigned non-resident writer. This causes 


a “command pending" 
partition's PIB. 


flag to ke set in the 


When the writer has started, it executes 


in the same way aS a resident writer and 
must ke terminated by a STOP command to 
allow processing of problem programs to be 


resumed in the partition. 


SYSTEM OUTPUT WRITER MODULES 


The following five MVT system 
writer modules are modified for MFT. 


out put 


e IEFSDO70 - Data Set Writer 


Routine 


Linkage 


e IEFSD0O79 - Linkage to 
Delete Routine 


CGueue Manager 


e IEFSDO84 - Wait Routine 
e TEFSD085 - DSB dandler Routine 
e TEFSDO&7 - Standard Writer Routine 


Descriptions of all other system output 
writer modules can pe fcund in IBM Systen/ 


360 Operating System: MVT Job Management, 
Program Logic Manual, Form Y28-6660. 


Data Set Writer Linkage Routine (IEFSDO070) 


This routine passes control to the 
appropriate writer routine via a LINK macro 
instruction. The normal linkage is to the 
Standard writer, IEFSDO08?7. If a special 
user-written output writer routine is 
requested, this routine passes control to 
that writer. Upon return from either writ- 
er, the routine passes control to data set 
delete routine IEFSD171 via an XCTL macro 
instruction which deletes the output data 
sets from the output queue. 


Linkage to Queue Manager Delete Routine 
(IEFSD079) 


Upen completion of a job, linkage module 
IEFSD079 passes control to queue manager 
delete routine IEFQDELO via an XCTL macro 
instruction to delete all control blocks 
and SMBS associated with the output job 
from the job queue. Following deletion, 
the routine then posts all reader ECBs that 
are waiting for space to indicate that 
Space is now available. (The reader ECB 
chain address is obtained from the master 
scheduler resident data area.) When all 
ECBS have been posted, control is returned 
to main logic routine IEFSDO082. 


Wait Routine (IEFSDO084) 


This routine serves as a multiple WAIT 
when there is no work in any of the output 
classes associated with the writer. It 
issues a WAIT macro instruction on the ECB 
list created by class name Setup routine 
IEFSDO81. When the system cutput writer 
enterS a wait state, the wait routine 
issues a message informing the operator 
that the writer is waiting for work. Any 
posting (such as a command, or work for the 
writer) causes control to be given to 
IEFSDO82. 
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DSB Handler Routine (IEFSDO85) 


DSB handler routine IEFSD085 is the 
setup module for printing data sets. It 
issues a GETMAIN macro instruction for the 
input DCB if it was not oktained before, 
and constructs a new fTIOT containing an 
entry for the input data set. It also sets 
up any user-written output writer program. 
A check is then made to determine if a 
pause is required between data sets or only 
at forms change. If a special form is to 
be used, the routine writeS a message to 
the operator telling him what form to put 
in the output device. The form change only 
occurs if the output device is unit record. 
This routine then passes control to linkage 
routine IEFSDO70 via an XCTL macro instruc- 
tion. 


Standard Writer Routine (IEFSD087) 


This routine first issues an OPEN macro 
instruction to open the output data set. 
If the data set was not opened by the 
problem program, no attempt is made to 
process the data set. After OPEN, a test 
is made to check for machine control char- 
acters. A switch is set that is interro- 
gated by PUT routine IEFSD089. The writer 
then passes control to transition routine 
IEFSD088 which creates header and trailer 
records. Upon return from IEFSDO&8, the 
writer routine checks the CANCEL ECB in the 
CSCB to determine if a CANCEL command has 
been issued for this writer. If the CANCEL 
ECB has been posted complete, control 
passes to transition routine IEFSD088 to 
create a trailer record. When control is 
returned from IEFSD088, the writer is 
closed. Control is then returned to link- 
age routine IEFSDO078 via a RETURN macro 
instruction. 


If the writer is not to be canceled, the 
writer routine issues a GET macro instruc- 
tion to read a record and checks for a 
control character. If no control character 
exists, the writer puts one in which causes 
the printer to skip one line or the punch 
to feed into the normal pocket. If the 
printer has overflowed, a skip is made to 
the next page. 


The writer then adjusts the pointer to 
the record so that it points to the first 
data character (instead of control charac- 
ter) and passes control to transition rou- 
tine IEFSD088 for trailer records. It then 
issues a CLOSE macro instruction to close 


the input data set, a FREEPOOL macro 
instruction to free the buffers, and 
returns control to linkage module IEFSDO78 


Via a RETURN macro instruction. 


66 


SYSTEM TASK CONTROL 


System task control (STC) 
initiates all tasks except the 


(Chart 30) 
initiator 


(START INIT). When the master scheduler 
determines that a START command with an 
identifier operand has been issued, it 


checks the validity of the partition speci- 
fied in the command, builds and chains a 
CSCB, places a pointer to the CSCB in the 
partition's PIB, and posts the partition. 


Note: If the procedure being started is 
for a system-assigned reader or writer, the 
CSCB pointer is placed in the master sched- 
uler resident data area. (See Appendix A 
for the format of the master scheduler 
resident data area). 


As shown in Figure 28, job selecticn 
module IEESD510 responds when the partition 
is posted, and calls STC when a_e START 
command for a reader or writer is recog- 
nized. If a reader or system output writer 
is to be started, STC must process a= job 
description Similar to a user's job 
description. 


The job description information for a 
reader or writer cones from three sources: 
the procedure library, JCL statements, and 
the operator. The procedure library con- 
tains standard descriptions of a reader and 
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JCL statements (corresponding to 
stream JCL) are stored internally; 
Statements invoke and modify the 
reader or writer vrocedure. The operator 
furnishes additional information in the 
operand of the START command; this informa- 
tion is edited into the internally stored 
JCL statements before they are used to 
invoke and modify the procedure. 


writer. 
input 
these 


INITIATING SYSTEM TASKS 


When initiator job selection module 
IEESD510 determines that a START command 
for a reader or writer has been entered, it 
passes control to START syntax check module 
IEEVSTAR via an XCTL macro instruction. 


START Syntax Check Routine (IEEVSTAR) 


The START syntax check module gets main 
storage for, and builds, the start descrip- 


tor table (SDT). This table (see Figure 
29) contains JCL statements constructed 
from information in the START command. 
These statements will be placed in the 


internally-stored job control language set 


The START syntax check module passes 
control to JCL Build module IEEVJCL which 
builds the Job Control Language Set. Each 


statement is built in an 88-character buff- 


0 (0) 2 
SDT SIZE Ident Flags Reserved 


4 (4) 
JCL Statement 
76 (4C) 1 l 
Ident Flags Reserved 
JCL Statement 
l l 
Ident Flags Reserved 
152 (98) 


JCL Statement 


224 (EO) 1 1 
Ident Flags Reserved 


JCL Statement 


l l 


JCL Statement 


372 (174) 1 1 
Ident Flags Reserved 





JCL Statement 


Figure 29. START Descriptor Table (SDT) 


er (obtained with a GETMAIN macro instruc- 
tion) from information in the SDT. A 
pointer to the first buffer is placed in 


the CSCB associated with the command; each 
buffer contains a pointer to the next, and, 
in the last 80 bytes, a card image of the 
JCL statement. 


Reader Control Routine (IEEVRCTL) 


Reader control routine IEEVRCTL then 
receives control and builds the interpreter 


entrance list (NEL), option list, and exit 
list. The interpreter entrance list con- 
tains the address of the JCLS in its third 
word. The reader control routine passes 


control to the reader via a LINK macro 


instruction. 


The reader, used as a closed subroutine, 
is the same routine that performs the 
reading task. The non-zero value of the 
third word of the entrance list indicates 
that the input stream is an internal data 
set. Since the input stream is internal, 
the reader issues a pseudo OPEN macro 
instruction to bring a_e special access 
method (a modified QSAM) into storage and 
places a pointer to the access method in 
the input DCB. This special access method 
reads the JCLS; it 1s entered from the 


expansion of the Standard GET macro 
instruction. 
The internally-stored job control lan- 


guage statements, and the statenents from 
the procedure library are analyzed and 
combined. The standard job description 
tables are built, and an input queue entry 
1s constructed; however, because bit 7 of 
the option switches field of the option 
list is off, the entry is not enqueued, and 
the reader or writer "“job™ cannot be 
selected by an initiator. If errors are 
detected during reader processing, appro- 
priate messages are placed in system mes- 
sage blocks, which are enqueuead in the 
message class queue. When processing is 
complete, the reader places the main 
storage address of the job control table 
(JCT) in the NEL and returns control to the 


reader control routine with a code that 
indicates whether processing was success- 
ful. The reader control routine then 


passes control to allocation interface con- 
trol routine IEEVACTL. 


Allocation Interface Control Routine 
(IEEVACTL) 


The reader control routine passesS_ con- 
trol to allocation interface control rou- 
tine IEEVACTL, with an indication of wheth- 
er the reader had encountered errors. The 
allocation interface control routine uses 


the WTO macro instruction to inform the 
operator of any errors that have been 
found. The routine then constructs'7 the 
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required allocate parameter list, and 
passes control to the I/O device allocation 
routine via a LINK macro instruction. 


I/O device allocation routine IEFSD210 
uses the JCT to find the appropriate tables 
in the input queue, allocates the necessary 
devices to the reader or writer, and issues 
any necessary mounting messages. The allo- 
cation recovery routines issue WTO macro 
instructions to inform the operator of any 
errors found during allocation. When allo- 
cation is complete, or if allocation cannot 
be performed, control is returned to the 
allocation control interface routine. 


routine 
module to be 

module and 
control to Write TIOT rou- 


Allocation control interface 
IFEVACTL determines if the 
given control is an authorized 
then transfers 
tine IEESD590. 


Note: A list of “authorized” modules is 
contained in a table in link-table module 
IFEVLKNT. 





Write TIOT on Disk Routine (IEESD590) 


Write TIOT on disk routine IEESD590 
checks that a reader has not been started 
in a small partition, writes the TIOT which 
is used for jok selection, and checks for a 
small partition writer. If a writer is to 
be started in a small fpartition, this 
module issues a POST macro instruction and 
a WAIT macro instruction for the SPIL and 
then passes control to job selection rou- 
tine IEFSD510 via an EXIT macro instruc- 
tion. If it is not for a small partition 
writer, control is transferred to linkcr 
routine IEFSD591. 


Linkor Routine (IEESD591) 


The linkor routine passes control to the 
requested routine via a LINK macro instruc- 
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tion. When the reader or writer stops, it 
returns control to the linkor routine, 
which checks for a small partition writer. 


If a small partition writer returned con- 
trol to the linkor routine, control then 
passes to IEFSD510. If a resident reader 


or large partition writer returned control, 
termination interface routine IEEVTCTL is 
given control via an XCTL macro instruc- 
tion. If a transient reader was suspended, 
IEFSD591 returns to job selection routine 
IEFSD510. 


POST Routine (IEESD592) 


POST routine IEESD592 checks the CSCB to 
determine if it has been freed; if not, it 
is freed. It also checks for a smail 
partition. The valid condition is posted 
in the SPIL or the PIB. The post routine 
then passes control to IEFSD510 via an EXIT 
macro instruction. 


SYSTEM RESTART 


The system restart functions may be 
requested at any time that a system restart 
becomes neceSsSary; e.g., end-of-day, end- 
of-shift, system malfunction, power fail- 
ure. This feature provides a means whereby 
a maximum amount of information concerning 


input work queues, output work queues, and 
jobs in interpretation, initiation, execu- 
tion, or termination can be preserved. 


System restart permits reinitialization, 
rather than a complete reformatting, of the 
job queue data set (SYS1.SYSJOBQE). 


MFT uses the MVT system restart modules. 
For a complete description of these 
modules, and how they function, see IBM 


System/360 Operating System: MVT Job Man- 


agement, Program Logic Manual, Form Y28- 
6660. 


st 








APPENDIX A: TABLES AND WORK AREAS 


This appendix contains descriptions and format diagrams of the major 
tables and work areas that are used by MFT job management. The tables 
and work areaS are in alphabetical order, as shown below: 

e Command Scheduling Control Block (CSCB) 

® Data Set Enqueue (DSENQ) Table 

e Interpreter Work Area (CIWA) 

e Job Control Table (JCT) 

e Job File Control Block (JFCB) 

e Job File Control Block Extension (JFCBX) 
e Life-of-Task Block (LOT) 

e Linkage Control Table (LCT) 

e Master Scheduler Resident Data Area 

e Partition Information Block (PIB) 

e Small Partition Information List (SPIL) 


e Step Control Table (SCT) 


e Step Input/Output Table (SIOT) 


Task Input/Output Table (TIOT) 


Tables and work areas are shown four or eight bytes wide for 
convenience, but are not necessarily drawn to scale. Tables that are 
stored in work queue entries are limited, by convention, to a length of 
176 bytes. 


The names of most fields are sufficient to describe the fields; those 
that require further explanation are described in the text accompanying 
the table. Where a macro instructicn may be used to include a DSECT of a 
table in routines using the table, the name of the mapping macro 
instruction is also given. The displacement of each field is shown to 
the left of each table; the values in parentheses show the hexadecimal 
displacement. 


COMMAND SCHEDULING CONTROL BLOCK (CSCB) 


Description: A command scheduling control btock (CSCB) (Figure 30) is an 
area for communications between the command scheduling routine (SVC 34) 
and the command execution routines. CSCBS are created (in the input 
format shown above) by several system routines. When a CSCB iS created, 
it is placed in a chain of CSCBs by the command scheduling routine. It 
remains in the chain until it is deleted from the chain by the command 
scheduling routine, which may also free the main storage occupied by the 
CSCB. A CSCB is created under the following circumstances: 


e A cCSCB is created by the command scheduling routine each time a 
task-creating command is encountered. If the task is a reading or 
writing task, the CSCB is deleted from the chain, and its main 
storage released, when the task terminates. 
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70 


0 (0) 5 
Address of the Next CSCB in the Chain 


Communications ECB Address of TCB 


Command Operand 


Initiator Storage Key Interpreter Counter 


144 (90) “Input CSCB 


Address of the Next CSCB in the Chain 


Communications ECB Address of TCB 


16 (10) 


Task Name or Unit Name 


24:(18) CANCEL ECB (First 4 Bytes) 
or 
Procedure Name (8 Bytes) 


32 (20) 
Address of JCL or JCT Reserved 


40 (28) 





Header 


SDT Address or TIOT Length Reserved Reserved 


48 (30) 
Address of Allocation Parameter List 
Queue Manager Parameter Area 
(Input Queue) 


88 (58) 


Queue Manager Parameter Area 
(Output Queue) 
Address of START Parameter List 


128 (80) 
Address of Procedure EXEC 


Statement PARM Field Address of Communications ECB 


136 (88) 
Address of Command Input Buffer Reserved 


144 (90) 


Control CSCB 


Figure 30. Command Scheduling Control Block (CSCB) 


e A CSCB is created by the queue management dequeue routine 






each time 


the initiator dequeues a job. This CSCB is deleted from the chain, 
and its main storage released, when the last step of the job has 


terminated. 


e A CSCB is created by a system output writer each time it 
DSB that was not preceded py another DSB in the current 
The CSCB serves aS a conmunicaticn area, allowing the 
(by operator command) of the subtasks established by the 


encounters a 
queue entry. 
canceliation 
writer. The 


CSCB is deleted from the chain, and its main storage released, when 











the writer encounters an SMs (or the last block in the current queue 


entry). 


A cCSCB is updated (and changed to the control format shown above if 
necessary) by the command scheduling routine when a CANCEL jobname (job 
selected), CANCEL writer device, MODIFY, or STOP command is encountered, 


Although most of the fields are self-explanatory, the following 


require further description: 


e Status Flags: This byte indicates the status (pending/not pending) 
cf the CSCB, and the action to be taken by the conmmanec scheduling 
routine. In addition to conrmand processing, the command scheculing 
routine may ke entered to add the CSCB to the chain, delete it, free 
its main storage, or to branch to the abnormal termination routine. 


e Type Flags: This byte indicates the type of activity with which the 


CSCB iS associated. 


e Communication Flags: This byte indicates the 
formed by the command processing routine. 


Mapping Macro Instruction: TEECHAIN 


DATA SET ENQUEUE TABLE (DSENQ) 


Description: The data set enqueue table (DSENQ) 


function to be per- 


(Figure 31) is built by 


the DD statement processor routine of the interpreter, and is used by the 
initiator to construct an ENQ macre instruction parameter list to prevent 


0 (0) 
Queue Address of This DSENQ Table 
4 (4) 
Queue Address of Last DSENQ@ Table 
8 (8) 
Name of Characters in all DSNAME Entries to Date 
12 (C) 
Number of DSNAME Entries 
to Date 
16 (10) 


Last DSNAME Entry * 


Zeros - ** 





Table ID 


End of DSENQ 





Exclusive/ 
Sharad Data Set Name 





%% If the last entry uses the last available space in the tables but no overflow occurs, 
the zero bytes are omitted. 


Figure 31. Data Set Enqueue Table (DSENQ) 


Appendix A: Tables and Work Areas 71 


72 


routines performing different tasks from using the same exclusive data 
sets concurrently. The table contains an entry for each data set (except 
temporary data sets) required for a job. 


INTERPRETER WORK AREA (CIWA) 


Description: The 2044-byte interpreter work area (IWA) (Figure 32) is 
obtained from subpool zero by a GETMAIN macro instruction in the 
interpreter initialization module (IEFVH1). The IWA contains information 
used by the interpreter routines; it is the area in which job description 
takles are built before they are placed in the work queues. 


Although most of the fields in the interpreter work area are 
self-explanatory, the following require further description: 


e Default Parameters: The PARM field of the FXEC statement in the 
reader procedure containS parameters to be used when no explicit 
Specification is made. These parameters specify whetner the instal- 
lation requires a programmer's name or account number on each JOB 
Statement, the priority to be assigned to a job if no friority has 
keen specified, whether commands in the input stream snould be 
processed (or ignored), and the device, primary quantity, and 
secondary quantity to be allocated to system output data sets. 


e Switches  A-F: These fields contain internal switches used for 
communicating status information among the interpreter routines. 


e System Input Allocation Table: This area contains a list of pointers 
to the UCBS corresponding to units available for allocation to system 
input data sets. 


e Queue Address Table: This area contains the addresses (in TTR form) 
of the next two records assigned to the job's input queue entry, and 
the addresses (in TTR form) of the first joblib SIOT, the first scan 
dictionary record, and the DD override table. 


e Input Stream Parameter List: This area describes the statement last 
encountered in the input stream, and contains a pointer to the field 
currently being processed. 


e Procedure Library Parameter List: This area describes the statement 
last read from the procedure library, and contains a pointer to the 
field currently being processed. 


e Procedure Library Merge Control Data: This area contains information 
used in merging statements from the input stream with statements from 


the procedure library. The information includes the statement names, 
the step names, and the names of the previous and next procedure 
steps. 


Mapping Macro Instruction: IEFVMIWA 


IWA Identifier 


NEL Address 


Procedure Library DCB Address 





Default Parameters 
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Unique Data Set Name Qualifier 


IWA Length 
8 (8) 
IWA Save Length 
16 (10) 
Input Stream DCB Address 
24 (18) 
56 (38) 
80 (50) 


Queue Manager Entry Point 


88 (58) 
Switch E Switch F 


Switch A Switch B 


Task 
Information 


Switch C Switch D 


Offsets to Table Areas 


120 (78) 


System Input Allocation Table 


184 (B8) 


Unit Type For CPO Step J/O Table 


192 (CO) 


224 (EQ) 


Queue Manager Parameter Area (QMPA) 


256 (100) 





Queue Address Table 


288 (120) 


Input Stream Parameter List (continued) 


296 (128) 
Procedure Library Statement Parameter List 
(continued) 


304 (130) 





Input Stream Parameter List 


Procedure Library Statement Parameter List Tels 


Information 


Procedure Library Merge Control Data 


352 (160) 


Reserved 


360 (168) 


Figure 32. 





Interpreter Work Area (IWA) 


Address of QMPA 


Address of PROC Referback Dictionary 


(continued) 


(Part 1 of 2) 
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(continued) 


360 (168) 





Address of PGM Referback Dictionary Address of DSENQ Table 
368 (170) 176 
Referback Dictionary (Input) 
544 (220) Go 
( ) 


Ref erback —<——S=— ee Search ise 
° 
720 e00, |---DSA 176] Information 
Job Control Table (JCT) 
896 (380) 1 1 
No. of Job 
N fS R d 
o. of SCTs Lib SIOTs eserve 
904 (388) 
Reserved 
] 
DD 
Internal Switch XI 
Number 
944 (3B0) 
DD Name Reference Table 
Reserved for Double Word Alignment 





1024 (400) Step 


Step Control Table (SCT) 


Information 
1200 (480) «-—____—_—_____— - 
System Message Block (SMB) 


1376 (560) 176 
Data Set Name Table (DSNAME) 


1552 (610) 176 
Volume Serial Table (VOLT) 


1728 (6CO) 


Reserved 


1768 (6E8) j 
Control and 

Scan Joint Reserved 
Switches 


Scan 
Switches 





1776 (6FO) 


Duplicate Table 
1792 (700) | | al 


ntermediate Text Buffer 
1968 (7B0) 
Text Begin Address Text Key Address 


t 


1976 (7B8) 
Text Number Address Text Length Address 


Statement 
Information 


Text End Address Current Level Last Level 
1992 (7C8) 4 
Current Register Save Area Control Routine Work Area 
2000 (7D0) 40 
Address of DCB 
Reserved 


Figure 32. Interpreter Work Area (IWA) (Part 2 of 2) 


1984 (7C0) 














C 


Form Y27-7128-3, Page Revised by TNL Y28-2349, 


JOB CONTROL TABLE (JCT) 


Description: The job control table (JCT) (Figure 33) is created in the 
interpreter work area by the job statement processor routine of the 
interpreter. It contains information from the JOB statement, job status 
information, and pointers to other tables in the job"s input queue entry. 
When the interpreter has processed all steps of a job, the JCT is written 
into the appropriate input queue according to priority; it is read back 
into main storage by the initiator job selection and job delete routines. 


Although most of the fields in the job control table are_ self- 
explanatory, the following require further description: 


e Job Status Indicators: The sixth byte of the JCT indicates the 
status of the job as shown below: 


Bit 0 is set to 1 of a JOBLIB DD statement is included with the job. 

Bit 5 is the job-failed bit. It is set to 1 if an error condition is 
encountered that causes the job to be terminated. 

Bit 6 is set to 1 if the job includes a cataloged procedure. 


e SYSOUT Classes: The first 36 bits of the five-byte field are used to 
indicate the system output classes that contain data. The four 
remaining bits are reserved. 


Mapping Macro Instruction: IEFAJCTB 


11/15/68 
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ot) Internal Job I | 
? Message Message 
Address in Queue of JCT Table ID = 00| Job Serial Status Class Level 
Number Indicators 


Job Name 


16 (10) 


Teleprocessing Terminal Name 


24 (18) 1 3 1 
Address in Queve of GDG 
Address in Queue of PDQ Reserved Bias Count Table Reserved 
32 (20) 1 1 
Address in Queue of First SCT Reserved Address in Queue of First SMB Reserved 
40 (28) 1 1 
Address in Queue of Job ACT Reserved Address in Queve of First DSB Reserved 
48 (30) 1 2 
Address in Queve of Last DSB Reserved Key of SMB Track First Job Condition Code 


56 (38 
22) First job 


Condition Reserved 
Operator 








Reserved for Seven Additional Job Condition Codes and Operators 


88 (58) 


TTR of DSEN@ Table 


152)98 SYS OUT Classes 





e Figure 33. Job Control Table (JCT) 


Data Set Name 


Element Name or Relative Generation Number 


48 (30) 


Element Name or Relative J/M +D/M 
Generation Number (continued) Interface 


56 (38) 


Reserved 


l 2 


Label Type | Reserved File Sequence Number | Volume Sequence Number 


72 (48) 


Data Management Mask 








80 (50) 
Data Set Creation Date Data Set Expiration Date Indicator Indicator 
Byte | Byte 2 
wee) Number ! Bufferi E Device 
of ain is Buffer Length — Character- Tape Reserved 
Rorreds nique Options istics Density 
96 (60) 2 
Reserved Data Set Organization aa Maximum Block Size 
104 (68) 
Number of | Number of Relative Lceation 
Logical Record Length | Channel Master of Key tn Logical RED Reserved 
Programs Index Tracks 
112 (70) 1 1 
Number of | Number of 
Reserved Overflow Volume 
Tracks Serials 
First Five Volume Serials 
] 
Fae L Queve Address of First JFCBX 
152 (98) 
Space : ; 
Primary Quantity Type Secondary Quantity Indicator 
Requested py ies 
160 (AO) Relative Add 2 
Divectacn Queai Main Storage Address of im aia 
irectory Quantity : : 
Split Cylinder JFCB Pe ee pee 
168 (A8) 
, Number of 
Main Storage Address A aeek dL 7 Volume am 
of SUBALLOC = JFCB NEIEGE USI Soke re Count Tracks per 
Cylinder 
176 (BO) 
Job File Control Block 
0 (0) 


Queue Address of Next JFCBX Reserved 


15 Additional Volume Serials 





96 (60) 


Reserved 


176 (BO) 
Job File Control Block Extension 


Figure 34. Job File Control Block (JFCB) and Extension (JFCBX) 
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JOB FILE CONTROL BLOCK (JFCB) AND EXTENSION (JFCBX) 


Description: A job file control block (JFCB) (Figure 34) is constructed 
in subpool zero (from information in a DD statement) by the interpreter 
DD statement processor routine. The JFCB is written into the job's input 
queue entry, and retrieved when a DCB with the corresponding name is 
opened. The information in the JFCE, which describes the characteristics 
of a data set, may be modified by the open routine. 


A JFCB contains enough space to record five volume serials. If more 
than five volume serials are specified, enough job file control block 
extensions (JFCBXs) to contain the additional volume serials are con- 
Structed; each JFCBX can contain up to fifteen additional volume serials. 


Additional information on the contents of the JFCB and JFCBX nay be 


found in the fublication, IBM System/360 Operating System: System 
Control Blocks, Form C28-6628. 


Mapping Macro Instruction: IEFJFCBN 


LIFE-OF-TASK (LOT) BLOCK 


Description: The 348-byte life-of-task (LOT) block (Figure 35) is built 
in a main storage area obtained fren subpool 253. It stores information 
for scheduling functions, and is used by system task control and 
initiators. It is created by the Job Select module for initiating 
problem programs, and by system task control for initiating readers and 
writers. 


The LOT block contains the linkage control table (LCT), a two-level 
register save area (REGSAVE), an input queue manager parameter area 
(QOMGR1), an output queue manager parameter area (QMGR2), the address of 
the ECB list, the address of the PIB, and the address of the SPIL. 


LINKAGE CONTROL TABLE (LCT) 


Description: The linkage control table (LCT) (Figure 36) is built in a 
main storage area obtained from sukpcol 253 by the initiator initializa- 
tion routine. It iS a communications area used by the routines of the 
initiator. 


Most of the fields in the LCT are self-explanatory; it shoula be 
noted, however, that the job termination status bit is the low-order bit 
of the cne-byte device features field. 


Mapping Macro Instruction: IEFALLCT 


MASTER SCHEDULER RESIDENT DATA AREA 


Description: The master scheduler resident data area (Figure 37), which 
is in the nucleus area of main storage, contains information used by the 
queue initialization, command scheduling, initiator, and I/0 device 
allocation routines. Its location is stored in the CVTMSER field of the 
communication vector table. 


Most of the fields in the master scheduler resident data area are 
self-explanatory; those fields that require further explanation are 
described below: 


e Queue Formatting Switch: If the high-order bit of this field is on, 
it indicates that the queue data set must be formatted. 


e Status Flags: The high-order bit is set on during system initializa- 
tion; the second bit is set on by the DISPLAY JOBNAMES command, and 
set off by the STOP JOBNAMES command; the third bit is set on by the 
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0 (0) 104 
Linkage Control Table 


104 (68) | A 
Register Save Area 1 
176 (BO) | | 


Register Save Area 2 


248 (F8) 
Input Queve Manager Parameter Area 
284 (11C) 
Output Queue Manager Parameter Area 
320 (140) 
Reserved 
328 (148) 
Address of ECB List Address of PIB 
336 (150) 


Address of SPIL 





eFigure 35. Life-of-Task (LOT) 8lcck 








0 (0) 
Reserved Address of Job Step CSCB Address of I/O Supervisor UCB Lookup Table 
8 (8 
wy 8) Devi 
TCB Address ulbos Linkor's Register Save Area Address 
Features 
16 (10) 
JCT Address SCT Address 
24 (18) 
Queue Address of SCT Allocate/IEFVPOST Communication Block Address 
32 (20) 
Error Code 
Communciations Area 
Register Save Area Address 
56 (38) 
Reserved ; i Address of Current SMB 
64 (40) 
Counter for Assigning Unique Volume Address of Message Class QMPA 
Serials to Passed Data Set Volumes 
72 (48) 


Return Address to System Task Control Routine 


q& Timer Work Area 


JOBLIB DCB Address 


96 (60) 


Allocate/Terminate Parameter List Address 





Figure 36. Linkage Control Table (LCT) 


VARY command to indicate that type I/O device allocation routine is to 
search the UCBs for a change in unit status. 


e MFT Switches: If the high-order bit of this field is on, it 
indicates that there is an active transient reader; the second bit is 
set on when there is a transient reader in main storage; the third 
bit is set on when there is a pending START reader command for a 
transient reader; the fourth bit is set on to indicate that it is an 
MFT environment; the fifth bit indicates that a system-assigned 
transient reader is running. 


e Transient Reader TTR: This field is used by the transient reader 
suspend routine to store the address of the work queue data set where 
the reader information was placed when the reader was suspended. 


e DEFINE Control Information: If the high-order bit of this field is 
on, it is a DEFINE operation; if off, it is IPL time. The second bit 
indicates that a list of the partitions" sizes and job class(es) has 
keen requested; the third bit indicates that there is an adjacent 

Cc partition check; the fifth bit is set on when the operator has 
, requested partition changes at IPL; the sixth bit indicates that a 
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small partition cannot terminate because of the DEFINE operation; the 
seventh bit indicates that a DEFINE command has been issued during 
operation; the eighth bit indicates that the system has storage 
protection. 


e Mapping Macro Instruction: IEEEASEB. 


0 (0) 
Address of CSCB Chain Reserved 
8 (8) 
Master Scheduler ECB Communications Task IPL ECB 
16 (10) 
Address of Job Queve ECB Address of PROCLIB UCB 
24 (18) 2 
Yeve A f SET AUTO 
Formatting poe a esia List Address of System Log Control Table 
Switch 
32 (20) Number! 
Status of Tracks Initiator Minimum Initiator 
t 
Flags in Initiator interpictenGoontes Protection Key Mask Partition Size 
Stack 
40 (28) 1 
Minimum Problem STOP [NIT Rcwaiea 
Program Partition Size Switch 
A8 (30) 
Reserved 
104 (68) 
System Queue Area Boundary Box 
112 (70) 
Transient Reader, Pending CSCB Pointer MFT Transient Reader CSCB Pointer MFT 
Switches Area 
120 (78) 
Transient Reader TTR DEFINE Control Information 
128 (80) 
Size of Scheduler Address of ECB Chain for Readers 
136 (88) 


Area Common to All Systems 





Figure 37. Master Scheduler Resident Data Area 


PARTITION INFORMATION BLOCK 


The 32-byte partition information block (PIB) (Figure 38) contains 
information used by the command processing and scheduler routines. Its 
location is stored in the TCBPIB field at displacement 124 (decimal) of 
the task control block (TCB). 


Although most of the fields in the partition infornation block are 
self-explanatory, the following require further description: 


CSCB Address of Pending Command 





4 (4) 
ECB Address 
8 (8) 
"No Work" ECB for the Initiator 
12 (C) 
Status Bits - A Address of Current Job Step CSCB 
16 (10) 
Status Bits - B SPIL Address 
20 (14) 
CSCB Address of Current Task in Partition 
24 (18) 
Protection Key Job Class Codes 
28 (1C) 
CSCB Address of Suspended Reader 
32 (20) 


eFigure 38. Partition Information Block (PIB) 


e ECB Address: Contains the address of ECB to be posted by job 
selection when the partition is made quiescent for partition 
redefinition. 


e "No Work" ECB for the Initiator: This ECB is posted by small 
partitions requesting service, the queue manager when a job has been 
enqueued, and by the DEFINE and START command routines. 


e Status A Information: 


Bit Setting Meaning 


0 0 Stop initiator 
1 START INIT issued 
1 1 Partition active 
2 1 Pending command 
3 1 Transient reader operating 
4 1 Reserved 
5 1 Partition is involved in redefinition 
6 1 System-assigned transient reader operating in this 
partiticn 
7 1 Problem program iS running 


e Status B Informaticn: 


Bit Setting Meaning 


0 1 Logical tracks added for initiator 
1 1 LOT block exits 
2 1 SPIL has been created 
e SPIL Address: The small partition information list (SPIL) is 


applicable to large partitions cnly. 


e Job Class Codes: Contains one to three codes for the partition, 
arranged in descending numerical order, i.e., GRP3 is in the second 
byte of the field, followed by GRP2 and GRP1. The first byte 
contains the protection key for the partition, if the system has the 
storage protection feature. 
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SMALL PARTITION INFORMATION LIST (SPIL) 


Description: The 32-byte small partition information list (SPIL) (Figure 


39) is a storage area for information pertaining to small partition 
scheduling. It is built in main storage obtained from subpool 0. The 
address of the ECBs provides for information to be passed between the 
small partition and the large partition that is performing initiation, 
allocation, or termination functions for the small partition. 


Most of the fields in the small partition information block are self 
explanatory; however, the status bits field is described below. 


Bits 0O and 1 contain ones if a START writer command has been entered. 
Bit 2 contains a one if a SPIL pointer has been stored in the PIE. 
Bit 5 contains a one if a problem program has requested termination. 


Bits O-7 contain zeros if a START INIT command was entered. 


0 (0) 
(ECBA) 
Event Control Block 
4 (4) 
(ECBB) 
Event Control Block 
8 (8) 
(ECBC) 
Event Control Block 
12 (C) 
Address of Small Partition TCB 
16 (10) 
Status Bits Reserved 
20 (14) 
Address of Allocate Parameter List (In Large Partition) if a Problem Program; 
TIOT, if a Reader or Writer 
24 (18) 
Address of CSCB for Writer 
28 (1C) 


Address of ECB List for Dequeve 





eFigure 39. Small Partition Information List (SPIL) 


STEP CONTROL TABLE (SCT) 


Description: The step control table (SCT) (Figure 40), is used to pass 
control information to the DD routine of the interpreter and to the 
initiator routines, which also contribute information to the table. This 
takle is created and initialized Ly the execute statement processor 
routine of the interpreter when an EXEC statement is read. One SCT is 
created for each step of a job. 


If the step is part of a previously cataloged procedure, the name of 
the step that called the procedure, if any, is entered. The following 
variable-content and indicator fields are included in the table: 





1. Internal Step Status Indicators: 


Bit 7 contains a one if an error condition caused the step to be 
terminated. 


2. PARM Count or Step Status Code: 


a. Interpreter: The number of characters specified in the PARM 
parameter of the EXEC statement is placed in this entry. 


b. Initiator: This table entry contains the condition code 
returned by the processing program. 


3. Step Type Indicators: 


Bit 0 contains a one if the following parameter definition appears 
in the EXEC statement: 


PGM=*.stepname.ddname 

Bit 1 indicates SYSIN is specified (DD *). 

Bit 2 indicates SYSOUT is specified. 

Bit 3 contains a 1 if JFCB housekeeping is complete. 


Bits 4, 5, and 6 are unused. 


Mapping Macro Instruction: IEFASCTB 


STEP INPUT/OUTPUT TABLE (SIOT) 


Description: The Step Input/Output Table (SIOT) (Figure 41), makes DD 
statement available to the initiator for use as a source of information 
for the TIOT and for providing DD information to allocation and 
disposition routines. When a DD statement is read, the interpreter 
creates a new SIOT and places the DD information into it. The individual 
bits of the disposition byte and of indicator bytes 57 through 60 in the 
SIOT are set to one to indicate the following conditions: 


BYTE 56: Scheduler Disposition 


Bit 0 Reserved 

Bit 1 Retain volume 

Bit 2 Private volume 

Bit 3 Pass data set 

Bit 4 Keep data set 

Bit 5 Delete data set 
Bit 6 Catalog data set 
Bit 7 Uncatalog data set 


BYTE 57: Indicator Byte Number 1 


Bit 0 Dummy data set 
Bit 1 SYSIN data set 
Bit 2 Split (primary) 
Bit 3 Split (secondary) 
Bit 4 Suballocate 

Bit 5 Parallel mount 
Bit 6 Unit affinity 
Bit 7 Unit separation 


Appendix A: Tables and Work Areas 


83 


Form Y27-7128-3, Page Revised by TNL Y28-2349, 11/15/68 


Internal l 


Queue Address of SCT Step Status Maximum Step Running Time wa 


Indicators 


8 (8) 2 ] 
PARM Count or Step Status |Length of Allocate Work Q Add : 
Code at Termination Area, or Number of SIOT s ow pest Eire LON Ent Reece 
16 (10) 
Queue Address of Allocate Work Area Reserved Queue Address of Next SCT Reserved 
24 (18) 3 1 ] 
Queue Address of First SMB Queue Address of Last SMB 
for Next Step Reserved for This Step Reserved 
32 (20) 1 1 
Queue Address of First ACT Entry 
for This Step Reserved Queue Address of VOLT Reserved 
40 (28) 3 1 
Queue Address of Dsname Table 
for This Step Reserved Name of Step That Called Procedure 
4 8 


8 (30) 











Name of Step That Called Procedure (Continued) Step Name 


6 (38) 9 
Relative Pointer to 


Step Entry in ACT Length of VOLT 


Step Name (Continued) 


64 (40) 


Hex 


Number of !| Number of ! Number of | | 
TOs in. ||Sete JFCBs to | ter Type 
This Step Messages Allocate melcoters 


PARM Field Values 


04 (68) ) 
Ste 
‘ : 
atus 


112 (70) 


“ tenaiha in Bytes) of 


Program Name (Continued) 
Dsname Table for This Step 


First Step Condition Code 


120 (78 
78) First Step | 3 


Condition Queue Address of First Condition SCT 
Operator 


Second Through Seventh Step Condition Entries 
160 (AO) 


21 Eighth Step! 3 
Eighth Step Condition Code| Condition Queue Address of Eighth Condition SCT Reserved 


168 (A8) 3] Number of | 
Queue Address of the First Message Step Queue Address of 
DSB in Message Class Class DSBs Status Last Legitimate SMB 
for this Step 





176 (BO) 


eFigure 40. Step Control Table (SCT) 
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BYTE 58: Indicator Byte Number 2 


Bit O Channel affinity 

Bit 1 Channel separation 
Bit 2 Volume affinity 

Bit 3 JOBLIB DD statement 
Bit 4 Unlabeled (no labels) 
Bit 5 Pool DD statement 
Bit 6 Defer mounting 

Bit 7 Received data set 


BYTE 59: Indicator Byte Number 3 


Bit O Volume reference 

Bit 1 SYSIN expected (procedures only) 
Bit 2 Reserved 

Bit 3 Volume reference in step 

Bit 4 SYSOUT was specified 

Bit 5 NEW data set 

Bit 6 MOD data set 

Bit 7 OLD or SHR data set 


BYTE 60: Indicator Byte Number 4 


Bit 0 Set by reader to indicate GDG single 
Bit 4 Step processed 
Bit 5 Intra-step volume affinity 
Bit 6 Data set is in PDQ 
Bit 7 1 = old or modified data set 
0 = new data set 


BYTE 93: Conditional Disposition 


Bits 0-3 Reserved 

Bit 4 Keep data set 

Bit 5 Delete data set 
Bit 6 Catalog data set 
Bit 7 Uncatalog data set 


BYTE 104: Step Status 


Bit 0 Reserved 
Bit 1 Reserved 
Bit 2 SCTMCVOL 
Bit 3 Reserved 
Bit 4 SCTSTPLB 
Bit 5 Reserved 
Bit 6 Reserved 
Bit 7 Reserved 


Mapping Macro Instruction: IEFASIOT 


TASK INPUT/OUTPUT TABLE (TIOT) 


Description: The Task Input/Output Table (TIOT) (Figure 42) provides 
data management routines with the addresses of the JFCBs and devices 
allocated to the data sets in a job step or system task. It is 
constructed by the I/O device allocation routine in main storage obtained 
from subpool zero. The allocation routine also places a copy of the TIOT 
on the appropriate job class queue with the other tables for the job 
step. After the step completes processing, the TIOT is brought in from 
the job queue and placed in the upper portion of the partition. The step 
is then terminated, and the TIOT is deleted. 


For further information on the fTIOT, see IBM System/360 Operating 
System: System Control Blocks, Form C28-6628. 


11/15/68 
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4 (4) 


12 (C) 


20 (14) 


28 (1C) 
Queue Address of Next SIOT 


36 (24) 
Queve Address of SIOT 
for VOLREF or SUBALLOC 


Queue Address of DD Name Table 


52 (34) 1 
Internal 


DD Number Count 


System Output Form Number 


84 (54) 


Queue Address of DSB for this Data Set 


92 (5C) 


Conditional 
Disposition 


132(84) 


Figure 41. 
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Volume 





Queue Address of SIOT Table ID 


Channel Separation and Affinity 


Unit Separation and Affinity 


] 
Reserved 
1 
Reserved 
2 
Reserved 
1 


Disposition 


Queue Address of JFCB 


Reserved 





Queve Address of SIOT System 


Output/Dependency Block Reserved 


Number of 
Volumes in 
VOLT 


Relative Pointer to 
Volume Table Entry 


1 
Indicator Bytes 


Unit Type 


System Output Program Name 


Reserved 


Queue Address of Next DSB 


Reserved 


DCB Reference Name 


Step Input/Output Table (SIOT) 





Job Name 
8 (8) 
Step Name 


16 (10) 


Name of Step Calling Procedure, or Zeros 


24 (18) 
Allocation 
Data 


32 (20) 
Address in Queue of 


DD Name (continued) JFCB or SIOT 


40 (28) 
Address of UCB Status Address of UCB 
or Link Value Bits or Link Value 





Zeros - End of TIOT 


Figure 42. Task Input/Output Table (TIOT) 
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APPENDIX B: MFT MODULES 


This appendix contains a table of new MFT modules, a group of tables showing the 
modules of each major component, and a brief description of each of the modules used by 
MFT. If you are looking for a specific module and know only the major component = and 
routine name, use Tables 3-14 which give a cross-reference to the source module. The 
source modules are in turn listed alphanumerically for easy access. If you know the 
source module name, go directly to the module descriptions. 


NEW MFT MODULES 
Table 2 lists all new modules implemented by MFT. This table is organized 


alphabetically by major component. 


Table 2. New MFT Modules 


(SS SS rn 
ABEND: I/O Device Allocation: Queue Management: 
IEAGTMO5 IEFSD551 IEFSD514 
IEAGTM06 IEFSD552 IEFSD572 
IEFSD557 


Communications Task: 


| | 
| | 
| | 
| [ 
[ | 
| | 
[ | 
| | 
[ IEEVWTOR Master Scheduler Task: | 
i | 
| Initiator: Reader/Interpreter: | 
| IEECIR50 | 
| IEFSD510 IEEDFIN1 IEFSD530 | 
| IEFSD511 IEEDFIN2 IEFSD531 | 
| IEFSD512 IEEDFIN3 IEFSD532 | 
| IEFSD513 IEEDFING IEFSD533 | 
| IEFSD515 IEEDFINS IEFSD536 | 
| IEFSD516 IEEDFIN6 IEFSD537 | 
| IEFSD517 IEEDFIN7 | 
| IEFSD540 IEEDFIN8 | 
| IEFSD541 IEEDFIN9Y | 
| IEFSD553 IEESD561 System Task Control: | 
| IEFSD554 IEESD562 | 
| IEFSD555 IEESD563 IEESD590 | 
[ IEFSD556 IEFSD564 IEESD591 | 
| IEFSD558 IEESD565 IEESD590 | 
| IEFSD559 IEESD566 IEESD591 | 
| IEFSD589 IEESD571 IEESD592 | 
| IEFSD598 IEFSD569 IEFSD534 | 
j IEFSD599 IEFSD535 | 
r Nucleus: | 
| IEESD568 IEFSD587 | 
| IEFSD567 IEFSD588 | 
f | 

J 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


MAJOR COMPONENT MODULES 
Tables 3 through 14 list all MFT modules according to major component. The tables 


appear in alphabetical order by component name. Within each component, routine names are 
listed alphabetically with a cross-reference to the module name. 
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Table 3. ABEND Modules 

ra ee ee ee 
| | Source | 
| Routine | Module | 
}-----------_-__-_--__-------- 4 --------- 
| ABDUMP | IEAATMO4 | 
| Indicative Dump IEAATMO3 {| 
| Initialization | IEAGTMOO | 
| Input/Output Purge | IEAGTMO6 | 
| Linkage | IEAATMO1 | 
| Main Storage Allocation | IEAATMO2 | 
| Termination | IEAGTMOS5 | 
Dc eta 8 le 


Table 4. Communication Task Modules 
[tig oe oe re a gt a ee 1 
| | Source | 
| Routine | Module | 
p————-___________---__-__ 
| Console Device Processor | IEECVPM | 
| Console Interrupt | IEECVCRA | 
| External Interrupt | IEECVCRX | 
| Initialization Routine | IEECVCTI | 
| Purge RQE | IEECVED2 | 
| Router | IEECVCTR | 
| Wait | IEECVCTW | 
| Write-to-Operator | IEECVWTO | 
| Write-to-Operator-With-Reply | IEEVWTCR | 
Dd 
Table 5. Initiator Modules 
.———---—------------- --—- —- -- —-7---------- 
| Source | 
| Routine | Module | 
}—---—____--__-_--__-_—_--}---—_—_+} 
Alternate Step Deletion | ILTEFSD516 
Data Set Integrity IEFSD541 
ENQ/DEQ Purge IEFSD598 
Job Deletion IEFSD517 
Job Initiation IEFSD511 
Job Selection IEFSD510 
Linkage to IEFSD510 IEFSD555 
Linkage to IEFSD511 IEFSD558 
Linkage to IEFSD512 IEFSD553 


Linkage to IEFSD516 IEFSD554 
Linkage to IEFSD534 IEFSD589 
Linkage to IEFSD541 IEFSD540 
Problem Program Interface IEFSD513 
Set Problem Program State IEFSD556 
Small Partition Module IEFSD599 
Step Deletion IEFSD515 
Step Initiation | IEFSD512 


a a al ed 


| 

| 

| | 
| | 
| | 
| | 
| | 
| ! 
| Linkage to IEFSD515 | IEFSD559 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| 

L 


Table 6. I/0 Device Allocation Modules 

a ee ae ee 1 
| | Source | 
| Routine | Module | 
|-------------------------__--}---------- { 
| Allocation Control | IEFXCSSS | 
| Allocation Entry | IEFSD210 | 
| Allocation Exit | IEFSD41Q | 
| Allocation Recovery Messages | IEFSJMSG | 
| Allocation Recovery | IEFXJIMP | 
| Automatic Volume Recognition | IEFXV001 | 
| Automatic Volume Recognition | | 
| Messages | IEFVMSG | 
| Automatic Volume Recognition | | 
| Non-standard Label Routine | IEFXVNSL | 
| DADSM Error Recovery | IEFXTOO3 | 
| Decision Allocation | IEFS5000 | 
| Demand Allocation | IEFWAOOO | 
| Device Strikeout | IEFX300A | 
| EXEC Statement Condition | | 
| Code Processor | IEFVKIMP | 
| EXEC Statement Condition | | 
| Code Processor Messages | IEFVKMSG | 
| External Action Messages | IEFWDOO1 | 
| External Action | IEFWDOOO | 
| Interface | IEFSD557 | 
| JFCB Housekeeping Control | | 
| and Allocate Processing | IWDCMLA1 | 
| JFCB Housekeeping Error Mes- | | 
| Sage Processing | IEFVMLS6 | 
| JFCB Housekeeping Error | | 
| Messages | IEFVMLS7 | 
| JFCB Housekeeping Fetch DCB | | 
| Processing | IEFVM2LS | 
| JFCB Housekeeping GDG All [ | 
| Processing | IEFVM4LS | 
| JFCB Housekeeping GDG Single | | 
| Processing | IEFVM3LS | 
| JFCB Housekeeping Patterning | | 
| DSCB | IEFVMSLS | 
| JFCB Housekeeping Unique | | 
| Volume ID | IEFVM76_ | 
| Mount Control-Volume Routine | IEFMCVOL | 
| Linkage Module | IEFWCFAK | 
| Linkage Module | IEFWDFA | 
| Linkage Module | IEFWSWIN | 
| Linkage Module | IEFXJFAK | 
| Linkage to JFCB Housekeeping | IEFVMMS1 | 
| Linkage to JFCB Housekeeping | IEFVMFAK | 
| Linkage to IEFXJIMP | IEFSD551 | 
| Linkage to IEFXJIMP | IEFSD552 | 
| Linkage to IEFXV001 | IEFAVFAK | 
| Linkage to Mount Control | | 
| Volume | IEFCVFAK | 
| Message Module | IEFWSTRT | 
| Message Module | IEFXAMSG | 
| Non-Recovery Error | IEFXKIMP | 
| Non-Recovery Error Messages’ | IEFXKMSG | 
| Separation Strikeout | IEFXHOOO | 
| Space Request | IEFXTOOD | 
| TIOT Compression | IEFXTOO2 | 
| TIOT Construction | IEFWCIMP | 
{| Unsolicited Device Interrupt | | 
| Handler | IEFVPOST | 
| Wait for Space Decision | IEFSDO097 | 
| Wait for Unallocation | IEFSD195 | 
a ee eT A J 
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Table 7. Interpreter Modules Table 8. Master Scheduler Modules 
Ge ea rg re ee es or ee a eae nae or ae ee ae ga ee ee ee pe a 
| Source [ | | Source | a 
| Routine | Module | | Routine | Module | 
|-—--—----—-------------—------ ——---——--- {  -----—-----------—-------—---- 4---------- { 
| Command Statement | IEFVHM [ | DEFINE Final Processor | IEEDFIN3 | 
| CPO Allocation Subroutine | IEFVSD1i2 | | DEFINE Initialization | IEEDFIN1 | 
| cPo | IEFVHG | | DEFINE Listing | IEEDFING | 
| Continuation Statement | IEFVBC | | DEFINE Message | IEEDFINS | 
| DD* Statement Generator | IEFVHB [ | DEFINE Syntax Check and | | 
| DD Statement Processor | IEEFVDA | | Router | IEEDFIN2 | 
| Data Set Name Table | | | DISPLAY A | IEESD566 | 
| Construction | IEFVDBSD | | DISPLAY R | IEESD567 | 
| Dictionary Entry | IEFVGI | | Queue Search | IEESD564 | 
| Dictionary Search | IEFVGS | | Queue Search Setup | IEESD563 | 
| End-of-File | IEFVHAA | | Service | IEESD565 | 
| EXEC Statement Processor | IEFVEA | | Syntax Check | IEESD562 | 
| Get Parameter | IEFVGK [ | Time-Slice Syntax Check | IEEDFIN6 | 
| Get | IEFVHA | | Wait/Router | IEECIRSO | 
| Housekeeping | IEFVHHB | L_—________ dd 
| Initialization | IEFVH1 | 
| Initialization | IEFVH2 [ 
| Interface | IEFSD533 | Table 9. Queue Management Modules 
| Job and Step Enqueue | IEFVHH [ .------------------—--------—- ——~—y---------- 1 
| Job Statement Processor | IEFVHA | | | Source | 
| Job Validity Check | IEFVHEC | | Routine | Module | 
| Linkage Module | IEFSD537 | }-—---—-—--—--—-—--—--—-—-—------—-—-—— -——---—----| 
| Message Module | IEFVGM1 | | Assign | IEFQASGQ 
| Message Module | IEFVGM2 | | Assign/Start | IEFQAGST | 
| Message Module | IEFVGM3 | | Branch | IEFQMLK1 | 
| Message Module | IEFVGM4 | | Control | IEFQBVMS | 
| Message Module | IEFVGM5S | | Delete | IEFQDELQ | 
| Message Module | IEFVGM6_ | | Dequeue | IEFQMDQQ | 
| Message Module | IEFVGM7 | | Dummy | IEFQMDUM | 
| Message Module | IEFVGM8 | | Enqueue | IEFQMNQQ | 
| Message Module | IEFVGM9 | | Interpreter/Queue Manager | [ 
| Message Module | IEFVGM10 | [ Interlock | IEFSD572 | 
| Message Module | IEFVGM11 | | Message Module | IEFSD311 | 
| Message Module | IEFVGM12 | | Queue Formatting | IEFORMAT | 
| Message Module | IEFVGM13 | | Queue Initialization | IEFSDO55 | 
| Message Module | IEFVGM14 | | Read/Write | IEFQMRAW | 
{ Message Module | IEFVGM1i5 | | Resident Main Storage | | 
| Message Module | IEFVGM16 | [ Reservation | IEFPRESD | 
| Message Module | IEFVGM1i7 | | Unchain | IEFQMUNQ 
| Message Module | IEFVGMi8 | t________________-________________1_____--___-_-4 
| Message Module | IEFVGM70 | 
| Message Module | IEFVGM78 | 
| Message Processing | IEFVGM | Table 10. Svc 34 Modules 
| Null Statement | IEFVHL | —--—--- - - -- - -- + -- 7 - = 7 
| Operator Message | IEFSD536 | | | Source | 
| Post-Scan | IEFVHF [ | Routine | Module | 
| Pre-Scan Preparation | IEFVHEB | —---—~—~—---———-— —-—-- —- —---—- ——- —-- -—— - + -—--------f 
| Queue Management Interface | IEFVHQ [ | CSCB Creation | IEEO803D | 
| Router | IEFVHE | | CSCB Marking IEEO703D | 
| Scan | IEFVFA | | DEFINE, MOUNT, CANCEL | IEFSD571 | 
| SCD Construction | IEFVspD13 | | HALT | IEE1403D | 
{| Symbolic Parameter | [ | Message Assembly | IEEO503D | 
| Processing | IEFVFB | | Message Assembly [| IEE2103D | 
| Termination | IEFVHN | | Reply Processor | IEE1203D | 
| Test and Store | IEFVGT | | Router | IEEQ403D | 
| Transient Reader Restore | IEFSD531 | | SET Command Handler | IEEO903D | 
| Transient Reader Suspend | IEFSD530 | | SET Command | IEEO603D | 
| Transient Reader Suspend [ | | START and STOP INIT | IEFSD561 | 
[ Tests | IEFSD532 | | Translator/Chain Manipulator | IEEQ0303D | 
| Vary Identification | IEFVHCB | | VARY and UNLOAD | IEE1103D 
ae | be oe eee ect Sao 
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Table 11. System Output Writer Modules 
6 a er ee ) maar | 
| | Source | 
| Routine | Module | 
| Class Name Setup | IEFSDO081 | 
| Command Processing | IEFSDO83 | 
| Data Set Delete | IEFSD171 | 
| Data Set Writer Interface | IEFSDO070 | 
| DSB Handler | IEFSDO85 | 
| Initialization | IEFSDO8O | 
| Job Separator | IEFSDO94 | 
| Linkage Module | IEFO78SD | 
| Linkage Module | IEFO79SD | 
| Linkage Module | IEFO82SD | 
| Linkage Module | IEFO83SD | 
| Linker | IEFSDO78 | 
| Linkage to Queue Manager | | 
| Delete | IEFSDO79 | 
| Main Logic | IEFSDO82 | 
| Message Module | IEFSDO96 | 
| Print Line | IEFSDO95 | 
| Put | IEFSD089 | 
| SMB Handler | IEFSDO86 | 
| Standard Writer | IEFSDO87 | 
| Transition | IEFSDO088 | 
| Wait | IEFsos4 | 
oo ee a a 
Table 12. System Restart Modules 
a a eel eee ee ee 1 
| Source | 
| Routine | Module | 
|}—-----------------—--__--—--------—_-} 
| Delete | IEFSD303 | 
| Initialization | IEFSD300 | 
| Jobnames Table | IEFSD302 | 
| Linkage Module | IEF300SD | 
| Linkage Module | IEF304SD | 
| Message Module | IEFSD312 | 
| Purge Queue Construction | IEFSD301 | 
| Scratch Data Sets | IEFSD304 | 
| Scratch Data Sets | IEFSD308 | 
| TTR and NN to MBBCCHHR | th 
| Conversion | IEFSD310 | 
be ee ee a ES a ee 








Table 13. System Task Control Modules 
ram mes aaa Sf el 
| Source | 
| Routine | Module | 
a ta Sa a eh te ---------J 
| Allocation Interface | IEEVACTL | 
| Internal JCL Reader | IEEVICLR | 
| Interpreter Control | IEEVRCTL | 
| JCL Edit | IEEVJCL | 
| Linkage to IEFSD535 | IEFSD587 | 
| Linkage to IEE534SD | IEFSD588 | 
| Linker | IEESD591 | 
| Link-Table | IEEVLNKT | 
| LPsw | IEFSD534 | 
| Message Writer | IEEVMSG1 | 
| Message Writer | IEEVSMSG | 
| Message Writing | IEEVOMSG | 
| POST | IEESD592 | 
| Problem Program Mode | IEFSD535 | 
| OMPA Builder | IEEVSMRA | 
| START Syntax Check | IEEVSTAR | 
| Termination Interface | IEEVTCTL | 
| Write TIOT on Disk | IEESD590 
a ae eee ene Oa ee eR Smee! Ce ee ee eee | 
Table 14. Termination Modules 
Dee ee ee ee are rae peer pee gee 1 
| | Source | 
| Routine | Module | 
~---------------—----——--- +---------- { 
| Disposition and Unallocation | | 
| Messages | IEFZGMSG | 
| Disposition and Unallocation | | 
| Messages | IEFZHMSG | 
| Disposition and Unallocation | IEFZGJB1 | 
| Disposition and Unallocation | IEFZGST1 | 
| DSB Processing | IEFYTVMS | 
| Job Statement Condition Code | | 
| Processor | IEFVJIMP | 
| Job Statement Condition Code | | 
; Processor Messages | IEFVJMSG | 
| Job Termination Control | IEFZAJB3 | 
| Job Termination Exit | IEFSD310Q | 
| Message Blocking | IEFYSVMS | 
| Message Module | IEFWTERM | 
| Message | IEFIDMPM | 
| Step Termination Control | IEFYNIMP | 
| Step Termination Control i | 
| Routine Messages | IEFYNMSG | 
| Step Termination Data Set [ | 
| Driver | IEFYPJB3 | 
| Step Terminate Exit | IEFSD220Q | 
| Step Termination Messages {| IEFYPMSG | 
| System Output Interface {| IEFSD017 | 
| Termination Entry | IEFSD42Q | 
| User Accounting Routine | | 
| Linkage | IEFACTLK | 
| User Dummy Accounting | IEFACTFK | 
bese eee sa ae ee ed 
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IEAGTMOA -- IEAATMOA 


MODULE DESCRIPTIONS 


This section contains a brief descrip- 
tion of each of the modules used by MFT. 
Modules are listed alphanumerically by 
module name; associated with each module is 
a descriptive name, which indicates’ the 
major component of the system to which the 
module belongs. Each module contains a 
brief statement of the purpose of the 
module. Where applicable, the description 
includes the names of the modules entry 
points, the names of the modules to which 
it passes control, the major tables and 
work areas to which it refers, its attri- 
butes, the names of the control sections it 


contains, and a page reference to _ the 
detailed writeup in the Job Management 
section. The names of the first and last 


modules on each page appear at the top of 
that page. 


IEAGTMOA: Supervisor -- ABEND STAE Test 


Routine 


This routine prevents asynchronous exits 
and stores the completion code (if not 
previously stored). It determines if con- 
trol should be returned to STAE after a 
purge error, if the Graphics Abend Exit 
routine should be entered, and if a valid 
STAE is in effect. 


e Entry: IGc0001C 
e Exit: xXCTL to IEAGTMO00 to continue 


ABEND processing 
to IEAATMOB if a valid STAE 
is in effect 
EXIT to IEAATMOB if an ABEND was 
issued by the Purge rou- 


tine during STAE 
processing 
EXIT to caller if graphics 
program 
e Attributes: Reentrant, disabled, 
privileged 
e Control Section: IGC0001C 
IEAGTMO0O: Supervisor -- ABEND 
Initialization Routine 
This routine provides purging for IQEs 
and WTOR requests, and cancels the task 
timer element. On detecting certain 
abnormal conditions, IEAGTMOO passes con- 


trol to the System Quiesce routine. 


e Entry: IGC0701C 
e Exit: XCTL to IEAATMOD if IEAGTMOO was 


entered from STAE 

to IEAGTM0O5 if this is a 
normal end 

to IEAGTM06 if this is an 
abnormal end 
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branch to IEAGTWST if a system 
task is attempting 
ABEND, or if the task or 
system has been speci- 
fied ‘must complete’ 


e Attributes: Reentrant, disabled for 
Svc interruptions, privileged 


e Control Section: IGC0Q701C 


IEAGTMO6: Supervisor -- ABEND Input/Output 
Purge Routine 


This routine purges I/0 operations in 
process and outstanding I/O requests. 


e Entry: IGC0601C 

e Exit: XCTL to IEAATMO1 

e Attributes: Reentrant, disabled for 
I/O and external interruptions, 
privileged 

e Control Section: IGC0Q601C 


IEAATMO1: Supervisor -- ABEND Validity 
Check Routine 


This routine performs validity checking 
of the MSS (main storage supervisor) queue, 
the load list, the active RB list, and the 
DEB queue. It dequeuves invalid control 
blocks, or terminates the queue at the 
point of error, and sets bits in the ABEND 
appendage to the boundary box to indicate 
invalid control blocks found on one or more 
lists. 


e Entry: I1GC0101C 


e Exit: XCTL to IEAATMOA 


disabled for 
interruptions, 


e Attributes: Reentrant, 
external and I/O 
privileged 


e Control Section: I1Gc0101C 


IEAATMOA: Supervisor -- ABEND Linkage 
Routine 


This routine checks for valid and inva- 
lid recursions. For an invalid recursion, 
control is passed to the System Quiesce 
Routine. For a valid recursion, a bit is 
set in the TCBFLGS field of the TCB to 
prevent an ABDUMP from being attempted. 
IEAATMOA determines the amount of main 
storage required by ABEND, and transfers 
control to the appropriate ABEND load 
module. 
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e Entry: 1IGC0111C 
e Exits: XCTL to IEAATMO2 if main 
storage must be 
*stolen'* 
to IEAATM03 if main 
storage is available 


and an indicative dump 
is requested 

to IEAATMO4 if Main 
storage is available 
and ABDUMP is requested 


to IEAATMO5 if main 
storage is available 
and no dump is 
requested 
branch to IEAGTWST (System 


Quiesce routine) if an 
invalid ABEND recursion 
has been detected 


e Attributes: Reentrant, disabled for 
external and I/0 interruptions, 
privileged 

e Control Section: 1IGC0111C 


IEAATMO2: Supervisor -- ABEND Steal LRB 
Main Storage Routine 


This routine ‘steals‘ main storage 
needed for ABEND functions that cannot be 
obtained via a GETMAIN macro instruction. 
The main storage is stolen from programs 
represented by LRBs on the loaded program 


list. 
e Entry: IGCO0201C 
e Exits: XCTL to IEAATM2A if there is no 


loaded program list or 
if enough main storage 
is not available from 
the LRBs 

to IEAATM2B if IEAATMO2 
has acquired the neces- 
Sary main storage 


e Attributes: Reentrant, disabled for 
external and I/O interruptions, 
privileged 

e Control Section: IGcC0201C 


IEAATM2A: Supervisor -- ABEND Steal 
Problem Program Main Storage Routine 


This routine *steals' main storage 
needed for ABEND functions from the lower 
end of the partition when it cannot be 
acquired either by a GETMAIN macro instruc- 
tion or by the steal routine provided by 
IEAATMO 2. 


IEAATMO2 -- IEAATMO4 
e Entry: I1G6cC0211C 
e Exits: XCTL to IEAATMO3 if indicative 


dump is requested 

to IEAATMO4 if ABDUMP is 
requested 

to IEAGTMO5 if no dump is 
requested or if a dump 
was previously 
attempted and failed 


e Attributes: Reentrant, disabled for 
external and I/O interruptions, 
privileged 

e Control Section: 1GC0211C 


IEAATM2B: Supervisor -- ABEND LRB Stack 
Routine 


This routine moves the LRBs whose main 
storage was stolen by IEAATMO2 to conti- 
guous locations in the low end of the freed 
area and resets the chain pointers in the 
LRBs. 


e Entry: IGC0221C 
e Exits: XCTL to IEAATMO3 if indicative 


dump is requested 

to IEAATMO4 if ABDUMP is 
requested 

to IEAGTM0O5 if no dump is 
requested or if a dump 
was previously 
attempted and failed 


disabled for 
interruptions, 


e Attributes: Reentrant, 
external and I/O 
privileged 


e Control Section: IGC0221C 


IEAATMO3: Supervisor -- ABEND Indicative 
Dump Routine 


This routine accumulates the information 
for an indicative dump and stores it in 
Main storage. 


e Entry: I1GC0301C 

e Exit: XCTL to IEAGTM05 

e Attributes: Reentrant, disabled for 
external and I/O interruptions, 


privileged 


e Control Section: I1IGC0301C 


IEAATMO4Y: Supervisor -- ABEND/ABDUMP 
Routine 


This routine determines if the user 
wants a full or partial ABDUMP, initiates 
the ABDUMP output, and calls an Svc 51 


(ABDUMP). 
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TEAGTMO5 -- IEECIR50 
e Entry: IGC0401C 
e Exits: xXCTL to IEAATMO3 for an indica- 


tive dump if the DCB 
has failed to open 

to IEAGTMO5 for initiali- 
zation of the next task 


e Attributes: Reentrant, disabled for 
external and I/O interruptions, 
privileged 

e Control Section: IGC0401C 


IEAGTM05: Supervisor -- ABEND Termination 


Routine 


all data sets, 
resets the TCB 
and transfers 


This routine closes 
purges the timer queue, 
fields, frees main storage, 
control to the job scheduler. 


e Entry: IGC0501C 
e Exits: xXCTL to IEFSD51K for scheduler- 
size partitions 
to IEFSD599 for small 
partitions 
e Attributes: Reentrant, disabled for 
external and I/O interruptions, 
privileged 
e Control Section: IGC0501C 


IEAGENQ1: Supervisor -~ Enqueuve Service 


Routine 


This routine constructs and processes 
control blocks to serialize the use of 
resources in a multiprogramming environ- 
ment. 


e Entry: IEAGENQ1 
e Exit: EXIT routine or to the 
dispatcher 


e Tables/Work Areas: Minor QCB, Major 


OCB, Queue element 


e Attributes: Reenterable 


e Control Sections: IGC0O48 and IEG056 


IEAGENQ2: Supervisor -- Shared DASD 
Enqueue Service Routine 


This routine is the enqueue’ service 
routine for systems that include the Shared 
DASD option. It is identical to IEAGENQ1 
except that additional processing is per- 
formed when a shared direct-access device 
is requested through the RESERVE macro 
instruction. 
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e Entry: IEAGENQ2 
e Exits: EXIT routine or to the 
dispatcher 


e Tables/Work Areas: 
QCB, Queue element 


Minor QCB, Major 


e Attributes: Reenterable 


IGCO4¥8 and IEGO56 


IEAGTWST: Supervisor -- System Quiesce 


Routine 


e Control Sections: 


This routine places the failing task in 


wait state, and permits the system to 
quiesce. 

e Entry: IECIWTST 

e Exit: To the supervisor 


e Tables/Work Areas: TCB 
e Attributes: Resident in nucleus, dis- 
abled, reusable 


e Control Section: JIEAFO3BP 


IEAOTIO1: Supervisor -- Timer Second Level 
Interruption Handler 


This routine maintains the timer queue 
when the timer option is not specified 
during system generation. It handles only 
the normal six hour interruptions. 


e Entry: IEAOTIO1L 
e Exit: To Timer/Extermal FLIH 


e Tables/Work Areas: SHPC, T4PC, LTPC 

e Attributes: Reenterable, disabled for 
system interruptions, resident, super- 
visor mode 


e Control Section: IEAOTIO1 
IEECIR5O: Master Scheduler -- Wait/Router 
Routine 


This routine waits until a command is 


issued, analyzes the command and passes 
control to _ the appropriate processing 
module. 

e Entry: IEECIR5O 

e Exits: IEESD562, IEEDFIN1 

e Attributes: Read-only, reenterable, 


resident in nucleus. 


e Control Section: IEECIR50 


e Page Reference: 44 
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IEECVCRA: Communications Task -- Console 
Interruption Routine 





This routine notifies the wait routine 
that a console read has been requested. 


e Entry: IEEBA1 
e Exit: Return to I0S 


e Tables/Work Areas: ECB, UCM, UCB 


e Attributes: Reenterable 


e Control Section: IEEBA1 


e Page Reference: 40 


IEECVCRX: Communications Task -- External 
Interruption Routine 


This routine switches control from the 
primary console device to an alternate 
console device when an external interrup- 
tion occurs. 

e Entry: IEEBC1PE 
e Exit: Return to IOS 
e Tables/Work Areas: UCM 
e Attributes: Reenterable 


e Control Section: IEEBC1PE 


e Page Reference: 41 


IEECVCTI: Communications Task -- 
Initialization Routine 


This routine sets up control blocks’ and 


attributes in the unit control module 
(UCM). 

e Entry: IEECVCTI 

e Exit: ITEECVCTW 


Tables/Work Areas: UCM 


Attributes: Read-only, reenterable 


e Control Section: JIEECVCTI 
e External References: IEEVRFRX 


IEECVCTR: 
Routine 


Communications Task -- Router 





This routine determines the type of 
request or interruption that occurred, and 
passes control to the appropriate process- 
ing routine. 


IEECVCRA -~- IEECVPM 





e Entry: IEECVCTR 

e Exits: XCTL to IEECVPMX (IGC0O107B), 
IEECVPMC (IGC1107B), or IEECVPMP 
(I1GC2107B) 


e Tables/Work Areas: UCM, SVRB, UCB 


e Attributes: Reenterable 


e Control Section:  JIEECVCTR 


e Page Reference: 40 


IEECVCTW: Communications Task -- Wait 


Routine 


This routine waits on all communications 
task ECBS associated with WTO/WTOR macro 
instructions. 


e Entry: IEECIR45 


e Exit: None 


e Tables/Work Areas: TCB, ECB, UCM 


e Attributes: Reenterable 


e Control Section: IEECIR4&5 


e Page Reference: GQ 
IEECVED2: Communications Task -—- Purge ROE 


Routine 


This routine scans and purges all out- 
standing request queue elements (RQEs) per- 
taining to the terminating task. 


e Entry: IEECVPRG 
e Exits: End-of-task, and ABEND 


e Tables/Work Areas: RQE, WQE, JCM, CVT 


e Attributes: Reenterable 
e Control Section: JEECVPRG 


IEECVPM: Communications Task -- Console 


Device Processor Routine 


This routine performs console read and 
write operations and checks for errors. 


e Entry: IEECVPM 
e Exit: XCTL to IEECVCTR (IGC0007B) 


e Tables/Work Areas: DCB, UCB, UCM 


e Attributes: Reenterable 


e Control Section: JIEECVPM 


e Page Reference: 40 
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IEECVWTO -- IEEDFIN6 


IEECVWTO: Communications Task -- 
Write-to-Operator Routine 


This routine processes all WTO macro 


instructions. 
e Entry: IGC0Q003E 
e Exit: Return to calling program 
e Tables/Work Areas: WQE, UCM, CVT, RQE 
e Attributes: Reenterable 
e Control Section: IGCQ003E 


e Page Reference: 41 


IEEDFINi: Master Scheduler -- DEFINE 
Command Initialization Routine 


This routine sets up data areas for 
partition definition and passes control to 
the appropriate processing module. 


e Entry: IEEDFIN1I 
e Exits: IEEDFIN3, IEEDFING, IEEDFINS 


e Attributes: Read-only, reenterable 


e Control Section: IEEDFIN2 


e Page Reference: 45 


IEEDFIN2: Master Scheduler -- DEFINE 
Command Syntax Check and Router Routine 


This routine checks the syntax of DEFINE 
command statements. If a syntax error is 
discovered, the statement is ignored and an 
error message is issued. If the syntax is 


correct, the information is stored and 
control is passed to the appropriate 
routine. 

e Entry: IEEDFIN2 

e Exits: IEEDFIN5S, IEEDFIN6, IEEDFIN7 


e Attributes: Read-only, reenterable 


e Control Section: IEEDFIN2 


e Page Reference: 45 


IEEDFIN3: Master Scheduler -- DEFINE 
Command Final Processor 


This routine determines that all infor- 
mation for the partition redefinition is 
correct, constructs a list of ECBs (one for 
each of the affected partitions) to be 
posted when the jobs in the partitions have 
terminated, and issues a message that 
DEFINE processing is complete. 
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e Entry: IEEDFIN3 
e Exits: IEEDFIN5, IEEDFIN8 


e Attributes: Read-only, reenterable 


e Control Section: IEEDFIN3 


e Page Reference: 47 


IEEDFING: Master Scheduler -- DEFINE 
Command Listing Routine 


This routine lists partition defini- 
tions. 

e Entry: IEEDFIN4 

e Exits: IEEDFIN3, IEEDFINS 


e Attributes: Read-only, reenterable 


e Control Section: IEEDFIN4Y 


e Page Reference: 45 


IEEDFIN5: Master Scheduler -- DEFINE 
Command Message Module 


This routine contains texts for operator 
messages required for DEFINE command pro- 
cessing. The message is constructed 
according to a code passed by the calling 
routine. IEEDFIN5 issues the requested 
message and passes control to IEEDFIN2 or 
the dispatcher. 


e Entry: IEEDFINS5 
e Exits: IEEDFIN2 or return to calling 
program 


e Attributes: Read-only, reenterable 


e Control Section: IEEDFINS 


e Page Reference: 45 


IEEDFIN6: Master Scheduler 
Task -- Time-Slice Syntax Check Routine 


» This routine checks the TMSL subparame- 
ters for proper syntax. 


e Entry: IEEDFIN6 
e Exits: IEEDFIN2, IEEDFIN5 


e Attributes: Read-only, reenterable 


e Control Section: IEEDFIN6 


e Page Reference: 47 





c 


Form Y27-7128-3, Page Revised by TNL Y28-2348, 11/15/68 


IEEDFIN]: Master Scheduler -- Keyword Scan 
Routine 


This routine checks keyword parameters 
for syntax errors. If a syntax error is 
discovered, the statement is ignored and an 
error message is generated. If the syntax 
is correct, the information is stored. 


e Entry: IEEDFIN?7 
e Exits: IEEDFIN2, IEEDFIN3, IEEDFING, 
IEEDFINS5 


e Attributes: Read-only, reenterable 


e Control Section: IEEDFIN7 


e Page Reference: 47 


IEEDFIN8: Master Scheduler —-- System 


Reinitialization Routine 


control 
entered 


This routine updates system 
blocks and boundary boxes with the 
partition definition information. 


e Entry: TEEDFIN8 
e Exits: ITEEDFINY 


e Attributes: Read-only, reenterable 


e Control Section: IEEDFIN8 


e Page reference: 47 


IEEDFINS: Master Scheduler -- Command 
Final Processor Routine 


This routine updates the task control 
blocks affected by time-slicing if time- 
slicing is specified. 


e Entry: IEEDFIN9 
e Exits: IEEDFIN5 


e Attributes: Read-only, reenterable 


e Control Section: IEEDFIN9I 


e Page Reference: 47 


IEESD561: SVC 34 -- START and STOP INIT 
Routine 

This routine processes the START and 
STOP INIT commands. 

e Entry: IEESD561 

® Exit: Return to caller 


e Tables/Work Areas: CSCB, PIB, M/S 
resident data area, CVT 


IEEDFIN7 -- IEESD564 
e Attributes: Reenterable, Transient 
read- only 
e Control Section: IEESD561 


e Page Reference: 43 


IEESD562: Master Scheduler -- Syntax Check 
Routine 


This routine checks syntax of the com- 
mand and sets internal codes’ for queue 
search, if required. 


e Entry: IEESD562 
e Exits: XCTL to IEESD563 for queue 


search, or XCTL to IEESD566 for DISPLAY 
active 


e Attributes: Read-only, reenterable 


e External References: None 


e Control Section: TEESD562 


e Page Reference: Wy 


IEESD563: Master Scheduler -- Queue Search 
Setup Routine 


This routine determines which queue is 
to be searched, reads and scans the queue 
control record, establishes parameters for 
the search, and transfers control to the 
queue search module. IEESD563 will write 
out updated queue control records. 


e Entry: IEESD563 
e Exits: XCTL to IEESD564 to search 


queue; XCTL to IEESD565 at completion 


e Tables/Work Areas: OCR, QMPA, CVT, 
CSCB 


e Attributes: Read-only, reenterable 


e Control Section: IEESD563 


e Page Reference: Wu 


IEESD564: Master Scheduler -- Queue Search 
Module 


This routine searches the work queues 
for the execution of the queue manipulation 
commands. 


e Entry: IEESD564 
e Exit: XCTL to IEESD563 


e Tables/Work 
OMPA, XSA 


Areas: QCR, CSCB, CVT, 


e Attributes: Read-only, reenterable 
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IEESD565 ~- IEESD566 


e Control Section: IEESD564 


e Page Reference: Ky 


IEESD565;: Master Scheduler -- Service 


Routine 


This routine frees storage obtained by 
IEESD563, links to the queue manager to 
enqueue an entry or queue control record on 
SYS1.SYSJOBQE, or links to write a message. 


e Entry: IEESD565 
e Exit: Return to caller 


e Tables/Work Areas: 
CVT 


QMPA, CSCB, QCR, 


e Attributes: Read-only, reenterable 


e External References: IEFQOMNO2, 


IEE0503D 
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e Control Section: IEESD565 


e Page Reference: 44 


IFESD566: Master Scheduler -- DISPLAY A 


Routine 


This routine builds a table and _ con- 
structs operator messages according to the 
processing required by a DISPLAY A command. 


e Entry: IEESD566 
e Exit: Return to caller (IEECIR50) 


e Tables/Work Areas: QMPA, CSCB, XSA, 


QCR, CVT 
® Attributes: Read-only, reenterable 


e Control Section: IEESD566 


e Page Reference: ay 
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IEESD567: Master Scheduler -- DISPLAY R 
Routine 
This routine constructs operator mes- 


Sages according to the processing required 


by a DISPLAY R command. 


e Entry: IEESD567 
e Exit: Return to caller (IEECIRS5O) 


e Attributes: Read-only, reenterable 


IEESD567 


Ccntrol Section: 


e Page Reference: 45 


IEESD568: Nucleus -- Master Scheduler 


Resident Data Area 


This routine contains the master sched- 
uler resident data area. 


e Entry: IEEMSER 
e Exit: None 


e Attributes: Not reusable 


e Control Section: IEESMER 
e Page Reference: 77 


IFESD571: SVC 34 -- DEFINE, MOUNT, CANCEL 


Routine 





This routine schedules the execution of 
the DEFINE, MOUNT, and CANCEL (for active 
jobs only) commands. 


e Entry: IFESD571 
e Exits: 
MOUNT - XCTL to IG0103D 


DEFINE - Return to caller 
CANCEL ~ Active and cancellable -- 


Enter ABTERM to force 
cancel 

Active and not cancellable 
-- POST and mark CSCB 


inactive; XCTL to IEE0803D 


e Tables/Work Areas: CSCB, PIB, M/S 


resident data area, CVT 
e Attributes: Reenterable 


e Ccntrol Section: IEESD571 


e Page Reference: 42 


IEESD590: System Task Control -- Write 
TIOT on Disk 


This routine writes the TIOT which is 
used by Job Selection (IEESD510) and checks 
For a small partition writer. 


IEESD567 -- IEEVACTL 


e Entry: IEESDS90 
e Exits: XCTL to IEFSD510 (small parti- 


tion writer) or XCTL to IEFSD591 
e Tables/Work Areas: TIOT, SPIL 
e Attributes: Reenterable 


e Control Section: IEESD590 


e Page Reference: 68 


IEESD591: System Task Control -- Linker 


Routine 


transfers control between 
interpreter or 


This routine 
system task control and an 
system output writer. 


e Entry: IEEFSD591 
e Exit: XCTL to IEEVTCTL 


e Tables/Work Areas: 


e Attributes: Reenterable 


e Control Section: IFESD591 


e Page Reference: 68 
IFESD592: System Task Control -- POST 


Routine 


This routine checks for an error indica- 
tion in the CSCB. It posts the error 
condition or a valid condition. 


e Entry: IEESD592 


e Exit: xXCTL to IEFSD510 


e Tables/Work Areas: None 


e Attributes: Reenterable 


e Control Section: ITEESD592 


e Page Reference: 68 


ITEEVACTL: System Task Control -- 
Allocation Interface Routine 


This routine sets up the interface 
between system task control and the I/0 
device allocation routine. 


e Entry: IEFEVACTL 
e Exits: To IEFW21SD or IEEVRWTC 


e Attributes: Reenterable 


e Control Section: ITEEVACTL 


e Page Reference: 67 
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IEEVICLR -- IEEVSTAR 


IEFEVICLR: System Task Control -- Internal 
JCL Reader 


This routine reads the internal job 
control language used in starting a reader 
Or writer. 


e Entry: IFEVICLR 


e Exit: Return to caller 


Tables/Work Areas: DCBD 


Attributes: Read-only, reenterable 


e Ccntrol Section: IEEVICLR 


IEEVJCL: System Task Control -- JCL Edit 
Routine 


This routine constructs the internal jok 
control language used in the START reader 
and START writer command execution 
routines. 


e Entry: IEEVJCL, from IEEVSTRT 
e Exit: XCTL to IEERCTL 


e Tables/Work Areas: SDT, CSCD 


Attributes: Reenterable 


e Control Section: IEEVJCL 


IEEVLNKT: System Task Control -- 
Link-Takle Module 


This routine contains the table of rou- 
tines that is scanned by IEEVACTL as a 
validity check for program linking. 


e Entry: IFEVLNKT 


e Attributes: Non-executakle 


e Ccntrol Section: IEEVLNKT 


IEEVMSG1: System Task Control -—~ Message 
Writer Routine 


This routine writes messages to the 
operator as required by system task 
control. 

°e Entry: from IEEVRCTL, IEEVACTL, or 
IEEVTCTL 
e Exit: Return to caller 


e Control Section: IEEVMSG1 


ITEEVOMSG: System Task Control -- Message 
Writing Routine 


This routine assembles and writes mes- 
sages to the operator. 
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e Entry: ITEEVOMSG 


e Exit: Return to caller 


e Control Section: IEEVOMSG 


IEEVRCTL: System Task Control -- 
Interpreter Control Routine 


This routine 
between system 
interpreter. 


provides an 
task 


e Entry: IEEVRCTL 


e Exits: To IEFVH1 and IEEVACTL 


e Tables/Work Areas: CVT, CSCB 


® Control Section: IEEVRCTL 


e Page Reference: 67 


ITEEVSMBA : System Task Control -- QMPA 
Builder 


This routine constructs a yueve manager 
parameter area (QMPA) referring to the 
message class queue for the use of the I/0 
Device Allocation routine. 


e Entry: ITEEVSMBA 


e Exit: To IEEVACTL 


e Tables/wWork AreaS: GMPA, LCT, SMB, IOB 


® Control Section: IEEVSMBA 


IEEVSMSG: System Task Control -- Message 
Writer Routine 


This routine writes messages to the 
operator as required by the master schecul- 
ing task and system task control. 


e Entry: I:EVSMSG, from IEEVSOPT, 
VATT1, IEEVMSG1, or IREVRTTC 


IEE- 


e Exit: Return to caller 


e Control Section: LEEVSMSG 


IEEVSTAR: System Task Control -- Start 
Command Syntax Check Routine 


This routine checks the syntax of a 
START command, and builds a Start descrip- 
tor table (SDT) containing the parameters 
of the command. 


e Entry: ITEEVSTRT 


e Fxits: To IEEVJCL, or IEEO0O503D 

® Tables/Work Areas: SDT, M/S ReSident 
Data Area, CVT, M/S TIOT, UCB XSA, and 
CSCB. 


interface 
control and an 
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e Attributes: Reenterable 


e Control Section: IEEVSTRT 
e Page Reference: 67 


IEEVTCTL: System Task Control -- 
Termination Interface Routine 





This routine initializes the necessary 
tables for terminating a task that was 
established via a START or MOUNT command. 


e Entry: IEEVTCTL, from IEEVWILK or 
IEFW31SD 

®@ Exit: To IEFW42SD, then return to 
supervisor 


e Tables/Work Areas: 
and CSCB 


TCB, JCT, SCT, IcT, 


e Attributes: Reenterable. Character 


Dependence Type C 


e Control Section: IEEVTCTL 


IEEVWTOR: Communications Task -- 
Write-to-Operator With Reply Routine 


This routine processes all WIOR macro 


instructions. 


e Entry: I1GC0103E 


e Exit: Return to calling program 
e Tables/Work Areas: WOE, RQE, UCM, CVT 
e Attributes: Reenterable 


e Control Section: IGC0Q103E 


e Page Reference: 41 


IEEO303D: 
Manipulator 


This routine translates 


Svc 34 -- Translator/Chain 


lowercase let- 


ters into uppercase, and manipulates the 
CSCB chain as requested by the caller of 
Svc 34. 

e Entry: IEE0303D 

e Exit: To IEEQ403D, or return to caller 


e Tables/Work Areas: CVT, M/S resident 
data area, CSCB, XSA 


e Control Section: IEE0Q303D 
ITEEO403D: SVC 34 -- Router Routines 


This routine identifies the command verb 
and passes control the appropriate routine, 
or manipulates the chain of CSCBs. 


IEEVTCTL -- IEEQ803D 


e Entry: IEEO4&03D 
e Exit: Depending on command verb, via 





XCTL to another SVC 34 module 


e Tables/Work Areas: M/S resident data 
area, XSA, CSCB 


e Control Section: IEEO4&03D 


e Page Reference: 42 


IEEO503D: SVC34 -- Message Assembly 
Routine 


This routine assembles and edits mes- 
sages for the command scheduling routine, 
and writes the messages to the operator. 


e Entry: IEEO503D 
e Exit: Branch on register 14 
e Control Section: IEE0503D 
IEEO603D: SVC 34 -- SET Command Routine 
This routine processes the SET command. 
e Entry: IEE0603D 
e Exits: To IEE0903D or IEFE0503D 


® Tables/Work Areas: xXSA, CVT, M/S resi- 


dent data area 


e Attributes: Reenterable 


e Control Section: IEE0603D 


IEE0703D: SVC 34 -- CSCB Marking Routine 


This routine schedules the execution of 
the STOP and MODIFY commands by finding and 
updating the appropriate CSCB and by issu- 
ing a POST macro instruction to the master 
scheduling task. 


e Entry: IEEO703D 
e Exits: Branch on register 14, or XCTL 





to IEE0803D or IEE0503D. 
e Tables/Work Areas: M/S Resident Data 
Area, XSA, CVT, CSCB 


e Attributes: Reenterable 


e Control Section: IEEOQ703D 


IEEO803D: SVC34 -~- CSCB Creation Routine 

This routine schedules the execution of 
RESET, HOLD, RELEASE, and DISPLAY commands 
by adding a CSCB to the cCSCB chain and 
issuing a POST macro instruction to the 
master scheduling task. The CANCEL command 
is also processed if the job is active. 
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IEEO903D -- IEFACTLK 


e Entry: IEE0803D 
e Exit: Branch on register 14 


e Tables/Work Areas: XSA, M/S resident 


data area, CVT and CSCB 


e Attributes: Reenterable 


e Control Section: IEEO803D 


IEE0903D: SET Command Handler 


This routine processes the date and time 
Operands of the SET command. 


e Entry: IEAQOTOO 


e Exit: svc 3 
e Tables/Work Areas: CVT 


supervisor 
interrupts, 


® Attributes: Reenterable, 
State, disabled for system 
transient 


e Control Section: IEAQOTOO 


IEE1103D: SVC 34 -- VARY and UNLOAD 
Routines 

This routine schedules the execution of 
the VARY and UNLOAD commands. 

e Entry: IEE1103D 

e Exits: Branch on register 14, or xXCTL 


to IEE0503D 
e Tables/Work Areas: M/S resident data 
area, XSA, CVT, UCB 
e Attributes: Reenterable, read-only, 
self-relocating 


e Control Section: IEE1103D 


IEE1203D: SVC 34 -- Reply Processor 


This routine checks the validity of the 
operator's reply command, and moves’ the 
operator's reply (if valid) to the buffer 
of the user that issued the respective 
WTOR. 


e Entry: IEE1203D 


e Exit: Return to caller 


e Tables/Work Areas: 
CXSA 


CVT, UCM, WQE, RQE, 


e Attributes: Reenterable 


e Control Section: IEE1203D 


e Page Reference: 42 
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IEE1403D: SVC 34 -- HALT Routine 





This routine schedules the execution of 2 
the HALT command by adding a CSCB to the 
CSCB chain and by issuing a POST macro 


instruction to the master scheduling task. 


e Entry: IEE1403D 
e Exit: IFBSTAT 


e Tables/Work Areas: XSA, M/S resident 
data area, CVT, and CSCB 


e Attributes: Reenterable 


e Control Section: IEE1403D 


IEE2103D: SVC 34 -- Message Assembly 


Routine 


This routine assembles and edits mes- 
sages for the command scheduling routine, 
and writes the messages to the operator. 


e Entry: IEE2103D 
e Exit: Branch on register 14 


e Control Section: IEE2103D 


IEFACTFK: Termination -- User Dumm 
Accounting Routine 


This routine takes the place of the 
user's accounting routine when a user 
accounting routine was specified at system 
generation, but none was supplied. 
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e Entry: IEFACTLK 
e Exit: Return to caller 


e Control Section: IEFACTLK 


IEFACTLK: Termination -- User Accounting 
Routine Linkage Routine 


This routine provides linkage between 
the termination routine and the _ user's 
accounting routine. It also sets up the 
required parameter list -~- including the 
execution time of the job step -- and reads 


the first record of the account control 
table. 

e Entry: IEFACTLK 

e Exits: To user'S accounting routine, 





return to caller. 





e Tables/Work Areas: LCT, JCT, SCT, 
JACT, SACT, QMPA 
e Control Section: IEFACTLK 


IEFACTRT: Termination -- Dummy Accounting 
Routine 


Form ¥27-7128-3, Page Revised by TNL Y28-2349, 11/15/68 
IEFACTRT -- IEFQASGOQ 

e Attributes: Reusable 
e Control Sections: IEFCVOL1, IEFCVOL2, 


This routine takes the place of the 
user-supplied accounting routine. 

e Entry: IEFACTRT 
e Exit: Return to caller 


e Control Section: IEFACTRT 


IEFAVFAK: I/0 Device Allocation -- Linkage 
to IEFXVOO1 


This routine passes control to the AVR 
routine (IEFXV001) via and xXCTL macro 
instruction. 

e Entry: IEFXvVO001 
e Exit: XCTL to IEFXVOO1 


e Control Section: IEFXVOOL 


IEFCVFAK: I/O Device Allocation -- Linkage 
to IEFMCVOL 


This routine passes control to Mount 
Control-Volume Routine IEFMCVOL via an XCTL 
Macro instruction to one of three entry 
points, IEFCVOL1, IEFCVOL2, or IEFCVOL3. 

e Entries: IEFCVOL3 


IEFCVOL1, IEFCVOL2, 


e Exits: XCTL to IEFCVOL1, IEFCVCL2, 


ITEFCVOL3 


e Control Section: IEFCVOL1 


IEFIDMPM: Termination -- Message Module 


This routine contains the messages’ used 


by the Indicative Dump routine. 


e Entry: IEFIDMPM 


e Attributes: Non-executable 


e Control Section: IEFIDMPM 
IEFFMCVOL: I/0 Device Allocation -- Mount 
Control-Volume Routine 


This routine will have a control volume 
mounted when a data set called for in a job 
step cannot be located on any currently 
mounted control volume. 

e Entries: IEFCVOL1, IEFCVOL2, IEFCVOL3 
e Exits: IEFVM1, 
(ITEFW41SD) 


IEFVMCVL, IEFVM6, IEFYN 


e Tables/Wwork Areas: LCT, 


JCT, 
SIOT, JFCB, VOLT, QMPA, UCB 


SCT, 


IEFCVOL3 


IEFORMAT : Queue Management -- Queue 
Formatting Routine 


This routine places the work queue data 
set in the format required by the MFT queue 
Management routines. 


e Entry: IEFORMAT, from IEFSDO55 
e Exit: Return to IEFSD055 

e Tables/work Areas: DCB, DEB 

e Attributes: Reusable 

e Control Section: IEFORMAT 


e Page Reference: 4g 


IEFQAGST: Queue Management -- Assign/Start 


Routine 


This routine sets up an ECB/IOB and 
prepares the queue manager parameter area 
for the assign routine. 


e Entry: IEFQAGST 
e Exit: Return to caller 


e Tables/Work Areas: 
area, OMPA, CVT 


Q/M resident data 


e Attributes: Reenterable 


e Control Section: IEFQAGST 


e Page Reference: 50 


IEFQASGQ: Queue Management -- Assign 


Routine 


This routine assigns records to a queue 
entry and assigns logical tracks as 
required. 


e Entry: JIEFQASGN 


e Exit: Return to caller 


e® Tables/Work 
area, OMPA, 


Areas: Q/M resident data 


CVT 
e Attributes: Reenterable 


e Control Sections: IEFQASGN, IEFQASNM 


e Page Reference: 51 
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IEFQBVMS -- IEFQMUNQ 


IEFQBVMS: Queue Management -- Control 


Routine 


This routine inspects the function code 
in the queue manager parameter area and, on 
the basis of this code, branches to the 
appropriate queue management routines. 


e Entry: IEFOQMSSS 


e Exits: To 
IEFOMNQOQ, 


IEFQAGST, IEFQOMRAW, 
or IEFQASGQ, return to caller 


e Tables/Work Areas: OQMPA 


e Attributes: Reenterable 


e Control Section: IEFQMSSS 


IEFQDELQ: Queue Management -- Delete 


Routine 


This routine makes those logical tracks 
assigned to a queue entry available for 
assignment to other queue entries. 


e Entry: IEFQDELE 


e Exit: Return to caller 


e Tables/Work Areas: 
resident data area, 


LTH, 
CVT 


QMPA, OCR, Q/M 


e Attributes: Reenterable 


e Control Section: IEFQDELE 


e Page Reference: 53 


ITEFOMDQOO: Queue Management -- Dequeue 


Routine 


This routine removes the highest priori- 
ty entry from an input queue or a system 
output queue. 


e Entry: IEFOCMDQ2 


e Exit: Return to caller 


e Tables/Work Areas: 
data area, CCR, LTH 


CVT, Q/M resident 


e Attributes: Reenterable 


e Control Section: IEFQMDQ2 
e Page Reference: 53 


IEFQMDUM: Queue Management -—- Dummy Module 


This routine prevents the occurrence of 
an unresolved external reference to module 
IEFQMSSS during system generation. 


e Entry: IEFOQMDUM 
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e Attributes: Non-Executable 


e Control Section: IEFQOMSSS 


ITEFOMLK1i: Queue Management -- Branch 


Routine 


This routine branches to the appropriate 
queue management routine on the basis of an 
assign or read/write function code issued 
by an initiator. 


e Entry: IJIEFOCMSSS 


e Exits: To IEFQASGO or IEFQMRAW 
e Tables/work Areas: QMPA 
e Attributes: Reenterable 


IEFQOMSSS 


ITEFQOMNQO: Queue Management -- Engqueue 


Routine 


e Control Section: 


This routine places an entry in an input 
queue or an output queue at the requested 
priority. 


e Entry: IEFQMNQ2 


e Exit: Return to caller 


e Tables/Work Areas: 
data area, QMPA, OCR, 


CVT, 
LTH 


Q/M resident 


e Attributes: Reenterable 


e Control Section: IEFQMNQ2 


IEFQMRAW: Queue Management -- Read/Write 


Routine 


This routine performs the conversion of 
a TTR into a MBBCCHER and reads or writes 
up to 15 records of the work queue data 
set. 


e Entry: IEFQMRAW 

e Exit: Return to caller 

e Tables/Work Areas: Q/M resident data 

area, QMPA, CVT, IOB/ECB 

e Attributes: Reenterable 

e Control Section: IEFQMRAW 
IEFQMUNO: ueue Management -- Unchain 
Routine 


This routine removes a task from the 


queue management no-work chain. 
e Entry: IEFCMUNC 


e Exit: Return to caller 
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e Tables/Work Areas: CVT, Q/M resident 
data area, OCR 


e Attributes: Reenterable 


e Control Section: IEFQMUNC 


IEFQRESD: Queue Management -- Resident 
Main Storage Reservation Module 


This routine reserves 140 bytes of resi- 
dent main storage for the queue-management— 
opened DCB/DEB and the master queue control 
record at nucleus initialization time. 


e Attributes: Non-executable 


e Control Section: IEFJOB 


IEFQRESD -- IEFSDO55 


IEFSD017: Termination -- System Output 
Interface Routine 


This routine provides an interface 
between the termination entry routine and 
system output processing. 


e Entry: IEFSDO017 

e Exit: To IEFSD42Q 

e Control Section: IEFSD017 
IEFSD055: Queue Management -- Queue 


Initialization Routine 


This routine constructs a resident DEB/ 
DCB, passes control to the queue formatting 


routine or the first phase of system 
restart, initializes the queue manager 
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resident data area, and (if required) 
passes control to the second phase of the 
system restart routine. 





e Entry: IEFSD055, from IEFQINTZ 

e Exits: To  IEFORMAT, IEF300SD, Or 
IEF304SD 

e Attributes: Reusable 


e Ccntrol Secticn: IEFSD055 


e Page Reference: 49 


IEFSD070: System Output Writer -- Data Set 
Writer Interface Routine 


This routine passes control to the stan- 
dard data set writer or to the user- 
Supplied data set writer routine. 


e Entry: IEFSDO70 


e Exits: To IEFSD0O87 or _ user-supplied 


routine via LINK, or to IEFSD171 via 
XCTL 
e Attributes: Reenterable 


e Control Section: IEFSDO70 


e Page Reference: 65 


IEFSD078: System Output Writer -- Linker 
Routine 


This routine determines whether the 
record obtained from the output queue entry 
is a DSB or SMB, and passes’ control, 
accordingly, to the DSB or SMB processor. 


e Entry: IEFSD078 

e Exits: To IFEFFSDO85, IEFSD086, or 
IFFSDO079 

e Attributes: Reenterable 


e Ccntrol Section: IEFSDO78 
IEFSDO79: System Output Writer -- Link to 
Queue Manager Delete Routine 

This routine passes control to the 


delete routine to delete the current output 
queue entry. 


e Entry: IEFSDO79 

e Exits: To IEFQDELQ and IEFSD082 
e Takles/Work Areas: QMPA 

e Attributes: Reenterable 

e Control Section: IEFSD079 


IEFSDO70 -- IEFSDO083 


e Page Reference: 65 


IEFSD080: System Output Writer -- 
Initialization Routine 


This routine initializes the system out- 
put writer by oktaining main storage for a 
parameter list and the output DCB, and 
opening the output DCB. 


e Entry: IEFSDO80 
e Exit: To IEFSD081 
e Tables/Work Areas: DCB, CSCB, TIOT, 
JFCB 
e Attributes: Reenterable 
e Control Section: IEFSDO080 
IEFSD081: System Output Writer -- Class 


Name Setup Routine 


This routine obtains main storage for, 
and initializes, a list of ECB pointers, 
ECBS, and queue management communication 
elements, depending on the system output 
classes specified for the writer. 


e Entry: IEFSDO81 


e Exit: To IEFSD082 


Tables/wWork Areas: CSCB, ECB 


Attributes:  Reenterable 


Control Section: IEFSD081 
IEFSD082: System Output Writer -- Main 
Logic Routine 


This routine obtains 
QMPAS and internal work areas, dequeues 
output queue entries, checks for operator 
commands, and passes control to the appro- 
priate routine. 


Main storage for 


e Entry: IEFSDO082 


e Exits: IEFSD083, IEFSD084, IEFSD078 


Tables/Work Areas: CSCB, ECB 


Attributes: Reenterable 


Control Section: IEFSD082 


IEFSD083: System Output Writer -- Command 
Processing Routine 


This routine processes MODIFY and STOP 
commands that apply to the writer. 


e Entry: IEFSDO083 
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IEFSDO84 -- IEFSD095 


e Exits: To IEFSD081 or IEEVTCTL 


Tables/Work Areas: 
ECB 


CSCB, DCB, OQOMPA, 


Attributes: Reenterable 


e Control Sections: IEFSD083, IEFSD83M 


IEFSDO84: System Output Writer -- Wait 
Routine 


This routine waits for an entry to he 
enqueued in an cutput queue corresponding 
to a class available to the writer. 


e Entry: IEFSDO84 
e Exit: To IEFSDO082 





Attributes: Reenterable 


Control Section: IEFSDO84 





e Page Reference: 65 


IEFSD085: System Output Writer -- DSB 
Handler Routine 


This routine initializes for data set 
processing, and informs the operator of the 
pause option in effect. 


e Entry: IEFSDO85, IEFO85SD, or IEF850SD 
e Exit: To IEFSD171 


e Attributes: Reenterable 


e Control Sections: IEFSD085, IEFSD85M 


e Page Reference: 66 


IEFSD086: System Output Writer -- SMB 
Handler 


This routine initializes for message 
processing, and extracts each message from 
the current SMB. 


e Entry: IEFSDO086, IEFO86SD 
e Exits: To IEFSDO88, IEFSD089, 


ITEFQMNQQO, IEFQOMRAW, IEFSDO085, IEFSDO78 


e Tables/work Areas: SMB, UCB, OQMPA, 
TIOT, CSCB, TCB 


e Attributes: Reenterable 





e Control Sections: IEFSD086, IEFSD86M 


IEFSD087: System Output Writer -- Standard 
Writer Routine 


This routine gets records from a data 


set. 
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e Entry: LEFSDO87 
e Exits: To IEFSDO88, IEFSDO&89, IEFSDO78 


e Tables/Work Areas: DCB 
e Attrikutes: Reenterable 


e Control Sections: IEFSD087, IEFSD87M 


e Page Reference: 66 


IFFSD088: System Output Writer -- 
Transition Routine 


This routine handles the transition 
between messages and data sets, and between 
data sets. 


e Entry: IEFSD088 
e Exit: To IEFSDO89 


e Tables/Work Areas: DCB 


e Attributes: Reenterable 


e Control Section: IEFSDO088 


IEFSD089: System Output Writer -- Put 
Routine 


This routine formats records as required 
and issues PUT macro instructions to write 
them on the output unit. 


e Entry: IEFSDO89 
e Exit: To IEFSDO88 


e Tables/Work Areas: DCB 


e Attributes: Reenterable 


e Control Sections: IEFSD0O89, IEFSD89M 


IEFSDO94:; System Output Writer -- Job 
Separator Routine 


This routine prints or punches a job 
name and system output class designation on 
the writer's output device. 


e Entry: IEFSDO94 
e Exits: TO IEFSDO88, IEFSDO89, 


IEFSD095, IEFSDO78 
e Attributes: Reenterable 


e control Section: IEFSDO94 


IEFSD095:; System Output Writer -- Print 
Line Routine 


This routine constructs the block let- 
ters used to separate jobs processed hy a 
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system output writer when the output data 
set is to be printed. 


e Entry: IEFSDO95 


e Exit: Return to caller 





Reenterable 


Attributes: 


e Ccntrol Section: IEFSDO095 


IEFSD096: System Output Writer -- Message 
Modul e€ 


This routine contains message headers 
and texts for messages to the operator. 


e Entry: IEFSD096 


e Attributes: Non-executable 


e Control Section: IEFSD096 
IEFSD097: I/0 Device Allocation -- Wait 


for Space Decision Routine 


This rcutine makes the decision whether 
to wait for direct access space, and pro- 
vides an interface with the I/0 device 
allocation space request routine so that 
retry and additional recovery passes may be 
made. 


e Entry: IEFSDO97 
e Exit: Branch on register 14 


e Tables/work Areas: LCT, TIOT, UCB 
e Attributes: Read-only, reenterable 


e Control Section: IEFSD097 


IEFSD171: System Output Writer -- Data Set 
Delete Routine 


This routine obtains records from an 
output queue entry, and deletes system 
output data sets. 

e Entry: IEFSDO71 
e Exits: To IEFOMNQ2, IEF850SD, 


IEFO86SD, IEFSDO78, or IEFQMRAW 


e Tables/Work Areas: DCB, SMB, UCB, CVT, 
OMPA, TIOT, CSCB, TCB 


e Attributes: Reenterable 





e Control Sections: IEFSD0O71, IEFSD71M 
IEFSD1953; I/O Device Allocation -- Wait 
for Deallocation Routine 


This routine provides the I/0 device 
allocation routine with the ability to wait 
for deallocation to occur during the execu- 


IEFSD096 -- IEFSD300 


tion of another task, when allocation can- 
not be completed because of current 
allocations. 


e Entry: IEFVAWAT 


e Exit: Return to caller 


e Tables/Work Areas: JCT, SCT, 
LCT, ECG, CSCB 


SIOT, 


e Attributes: Read-only, reenterable 


e Control Section: "IEFSD095 


IEFSD210: I/O Device Allocation -- 
Allocation Entry Routine 


This routine provides an interface for 
entry to the I/O device allocation routine 


operating in a multiprogramming environ- 
ment. 

e Entry: IEFW21SD 

e Exits: To IEFVK, IEFVM or IEFWDOOO 


e Tables/wWork Areas: JCT, LCT, SCT, SMB, 


QOMPA, CVT 


e Attributes: Read-only, reenterable 


e Control Section: IEFWLISD 


IEFSD220: Termination Routine -- Step 


Terminate Exit Routine 


This routine provides an interface 
between the termination routine and the 
step delete or alternate step delete rou- 
tine when a step has been terminated. 


e Entry: IEFW22SD 
e Exit: Return to caller of termination 


routine 


e Tables/Work Areas: 
OMPA, ECB 


JCT, SCT, SMB, LCT, 


e Attributes: Read-only, reenterable 


e Control Section: IEFW22SD 


e Page Reference: 64 
IEFSD300: System Restart -- Initialization 


Routine 


This routine reads all QCRsS and logical 
track header records into main storage, 
builds tables A, B, and C, and removes from 
Table A all the LTH entries corresponding 
to logical tracks in the free-track queue 
Or in one of the other queues. 


e Entry: IEFSD300 
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IEFSD301 -- IEFSD319 


e Exit: To IEFSD301 


e Tablies/Work Areas: System restart work 
area, Takkle A, Table B, Table C 
e Attributes: Reenterable 


e Control Section: IEFSD300 


IEFSD 301: System Restart -- Purge Gueue 


Construction Routine 





This routine searches Table A for the 
last ITH corresponding to each queue entry, 
determines the type of entry, and _con- 
structs the purge queue. 


e Entry: IEFSD301 
e Exit: To IEFSD302 


e Tables/Work Areas: System restart work 
area, Table A, Table C purge queue, 
interpreter jobnanes table 


e Attributes: Reenterable 


e Control Section: IEFSD301 





IEFSD302: System Restart -- Jobnames Table 
Routine 


This routine removes from Table A _ all 
logical tracks assigned to dequeuved input 
or RJE queue entries, and builds a table of 
jobnares for incomplete input and RJE queue 
entries and dequeued input queue entries. 


e Entry: IEFSD302 
e Exit: To IEFSD303 


e Tables/Work Areas: System restart work 
area, Table A, Table C, and the 
interpreter/initiator jobnames table 





e Attributes: Reenterable 


e Control Secticn: IEFSD302 


IEFSD303: System Restart ~- Delete Routine 


This routine creates a queue entry of 
the remaining logical tracks and deletes 
that entry, thus assigning those tracks to 
the free-track queue. 


e Entry: IEFSD303 
e Exit: Return to caller 


e Tables/Work Areas: 
area, QMPA, Table A 


System restart work 


e Attributes: Reenterable 


e Control Section: IEFSD303 
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IEFSD304; System Restart -- Scratch Data 
Sets Routine 


This routine informs the operator of the 


names of jobs being processed by an inter- 
preter, and scratches temporary data sets 
generated for incomplete input queue 
entries. 

e Entry: IEFSD304 

e Fxits: To IEFSD055, IEFSD308 


® Tables/Work 
look-up takle 


Areas: CVT, UCB address 


e Attributes: Reenterable 


e Control Section: IEFSD304 


IEFSD305: System Restart -- Reenqueue 
Routine 


This routine dequeues the entries in the 
purge queue and reenqueues them in the 
appropriate input or output queue and 
informs the operator of the names of jobs 
in the process of initiation. 


e Entry: IEFSD305 


e Exit: IEFSD304 

e Tables/Work Areas: System restart work 
area, purge queue, JCT, SCT, JFC5, DSB, 
SCD, SIOT. 


e Attributes: Reenterable 


e Control Section: TEFSD305 


IEFSD308: System Restart -- Scratch Data 
Sets Routine 


This routine scratches’ the 
data sets generated for 
queue entries. 


temporary 
incomplete input 


e Entry: IEFSD308 
e Exit: Return to caller 


e Tables/Work Areas: DSCB, DCB, UCB, 


CVT, VTOC, DEB 


e Attributes: Reenterable 


e Control Section: IEFSD308 


IEFSD3190: Termination Routine ~-- Job 


Termination Exit Routine 


This routine provides an interface 
between the termination routine and the 
step delete or alternate step delete rou- 
tine when the last step of a job has been 
terminated. 
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e Entry: IEFW31SD 
e Exit: Return to caller of termination 
routine 


e Tables/Work Areas: JCT, SCT, SMB, 
QMPA, ECB, CVT, M/S resident data area 
e Attributes: 


Read-only, reenterable 


e Control Section: IEFW31SD 


IEFSD 310: System Restart -- TTR and NN to 
MBBCCHHR Conversion Routine 


This routine converts a relative record 
address (NN) or a relative track and record 
address (TTR) to an actual disk address 
(MBBCCHHR). 


e Entry: IEFSD310 


e Exit: Return to caller 
e Tables/wWork Areas: CVT 
e Attributes: Reenterable 


e Control Section: IEFSD310 


IEFSD311: Queue Management -- Message 
Modul e€ 


This routine contains the messages 
required by the queve initialization rou- 
tine (IEFSD055). 


e Entry: 
SD55MSG3 


IEFSD311, SD55MSG1, SD55MSG2, 


e Attributes: Non-executable 


e Control Section: ITEFSD311 





IEFSD312: System Restart -- Message Module 


This routine contains the messages 
required by the system restart routines. 
IEFSD312, SD304MG1, 


e Entry: SD304MG2, 


SD305MG1 
e Attributes: Non-executable 


e Control Section: IEFSD312 


IEFSD4190: I/O Device Allocation -- 
Allocation Exit Routine 


This routine provides an interface for 
exit from the I/O device allocation routine 
operating in a multiprogramming' environ- 
ment. 

e Entry: IEFW41SD, IEFW1IFAK, IEFW2FAK 

e Exits: To IEFVM, or return to caller 


IEFSD310 -- IEFSD511 


e Tables/Work Areas: 
OMPA 


JcT, LCT, SCT, SMB, 


e Attributes: Read-only, reenterable 


e Control Section: IEFW41SD 


IEFSD42Q: Termination Routine —-- 
Termination Entry Routine 


This routine provides an interface for 
entry to the termination routine operating 
in a multiprogramming environment. 


e Entry: IEFW4&2SD 


e Exit: To IEFYN 


Tables/Work Areas: JCT, SCT, SMB, LCT, 


TIOT 
e Attributes: Read-only, reenterable 
e Control Section: IEFW42SD 
IEFSD510: Initiator -- Job Selection 
Routine 


This routine selects a system or problem 
program job. This module executes only in 
a large (scheduler-size) partition. 


e Entry: IEFSD510 
e Exits: Branch to IEFSD511 or IEFSD515, 
XCTL to IEES596SD or IEFSD531 


e Tables/Work Areas: 


LOT block, 
SPIL, CVT, TCB, PIB 


CSCE, 


e Attributes: Read-only, reenterable 


e Control Section: ITEFSD510 
e External References: IEFQOMDOQG, 
IEFQMUNC 
e Page Reference: 57 
IEFSD511: Initiator -- Job Initiation 
Routine 
This routine initializes information 


pertaining to a job. 


e Entry: IEFSD511 
e Exit: Branch to IEFSD541 


e Tables/Work Areas: lLife-of-Task Block, 
CSCB, JCT, SCT, SCD, PIB, IOB2 

e Attributes: Read-only, Reenterable 

e Control Section: IEFSD511 


e External References: IEFQMRAW 
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IEFSD512 -- IEFSD516 


e Page Reference: 62 


IEFSD512: Initiator -- Step Initiation 
Routine 


This routine passes control to alloca- 
tion as a closed subroutine via ae LINK 
Macro instruction. If an allocation error 
occurs, it passes control to the Alternate 
Step Deletion routine. Otherwise, it con- 
tinues normally and schedules a job step. 


e Entry: IEFSD512 

e Exits: Branch to IEFSD513 or IEFSD516 

e Tables/work Areas: LOT Block, JCT, 
SCT, APL, TIOT, CSCB, IOB1, IOB2 

e Attributes: Read-only, reenterable 

e Control Section: IEFSD512 

e External References: IEFQOMRAW, 


IEFSD556, IEFSD514 


e Page Reference: 62 


IEFSD513: Initiator -- Problem Program 
Interface 


This routine prepares the partition for 
problem program execution by moving the 
TIOT to the highest available storage area. 


The routine also opens JOBLIB and FETCH 
DCBs, if required. A final check is made 
to determine if a CANCEL command has_ been 
received for the job before the problem 
program is brought into the partition and 
given control. If scheduling was performed 
for a small fartition, IEFSD513 communi- 
cates with the small partition. 


e Entry: IEFSD513 
e Exits: XCTL to problem program, ABEND, 


or Branch to IEFSD510 


e Tables/Work Areas: LOT Block, Transfer 
Parameter List, TIOT, User‘s Parameter 
List, TCB, CVT, PIB, CSCB, SPIL, APL, 
JCT, SCT, DCB 


e Attributes: Read-only, reenterable 
e Control Section: IEFSD513 


e Page Reference: 63 


IEFSD514: Queue Management -- Table 
Breakup Routine 


This routine reads and writes tables 
which may be required by the job scheduler. 
The routine breaks the tables into 176-byte 
records, writes the records on disk, and 


108 


retrieves the records from disk to 
Struct the tables in main storage. 


recon- 


e Entry: IEFSD514 
e Exit: Return to caller 


e Tables/Work Areas: 
List 


OMPA, TBR Parameter 


e Attributes: Read-only, reenterable 


e Control Section: IEFSD514 


e External References: 


I EFQMRAW 


IEFQASGN, 


e Page Reference: 54 


IEFSD515: Initiator -- Step Deletion 
Routine 


This routine retrieves the TIOT and 
Life-of-Task Block from disk, reads in the 
JCT and SCT, and branches to termination, 
which is used as a closed subroutine. It 
also reads in the SCT for the next step to 
be scheduled, if required. 


e Entry: IEFSD515, SMALTERM, or GO 
e Exits: XCTL to IEFSD512 or Branch to 





IEFSD517 or IEFSD510 


e Tables/work Areas: Life-of-Task Block, 
Terminate Parameter List, CVT, ‘TCB, 
PIB, I0OB, CSCB, DCB, JCT, SCT, SPIL 


e Attributes: Read-only, reenterable 


e Control Section: IEFSD515 


References: 
IEFSD420, IEFSD598 


e External 
IEFSD514, 


IEFOMRAW, 


e Page Reference: 64 


IEFSD516: Initiator -- Alternate Step 
Deletion Routine 


This routine provides an interface with 
termination when an allocation error occurs 
during step initiation. Termination is 
used as a closed subroutine. If required, 
this routine reads the SCT of the next step 
to support job flushing. 


e Entry: IEFSD516 
e Exits: Branch to IEFSD512 or IEFSD517 


e Tables/Work Areas: lLife-of-Task block, 
CSCB, Terminate Parameter List, SCT 
e Attributes: Read-only, reenterable 


e Control Section: IEFSD516 








c 


c 





e External References: LEFQMRAW, 
TEFSD4& 20 
e Page Reference: 64 
IEFSD517: Initiator -- Job Deletion 
Routine 


This routine deletes the disk queue 
entry for a terminated job and unchains and 
deletes the CSCB for the job. 


e Entry: IEFSD517 
e Exit: Branch to IEFSD510 


e Tables/Work Areas: 
block, SPIL 


CSCB, Life-of-Task 


e Attributes: Read-only, reenterable 





e Control Section: IEFSD517 





e External References: 


IEFSD598 


IEFQDELE, 





e Page Reference: 64 


IEFSD530: Interpreter -- Transient Reader 
Suspend Routine 


This routine closes the reader input 
data set and procedure library, and _ saves 
data required to restore the reader. 





e Entry: IEFSD530 
e Exit: Return to caller 
e Tables/Work Areas: IWA, TIOT, LWA, 


QMPA, CVT, UCB, MSRC, PIB, CSCB 


e Attributes: Read-only, reenterable 





e Control Section: IEFSD530 





e External References: IEFSD514, IEF- 
QOMRAW, IEFQASNM, IEFQASGN 


e Page Reference: 56 


IEFSD531: Interpreter -- Transient Reader 
Restore Routine 


This routine restores the information 
required to "restart" a transient reader 
after it has been suspended. It reopens 
the reader input data set and procedure 


library. 
e Entry: IEFSD531 
e Exit: XCTL to IEFVHCB 


e Tables/Work Areas: IWA, 
CVT, UCB, MSRC, PIB, CSCB 


TIOT, QMPA, 


IEFSD517 -- IEFSD535 
e Attributes: Read-only, reenterable 
e Control Sections: 


IEFSD531, IEFPH2 


e External References: IEFSD514, IEF- 
OMRAW, IEFOQASNM, IEFQASGN 


e Page Reference: 56 


IEFSD532: Interpreter -- Transient Reader 
Suspend Tests 


This routine determines the status of a 
transient reader. IEFSD532 receives con- 


trol from IEFVHH after a job has been 
enqueued. 
e Entry: MIEFSD532 
e Exits: Branches to IEFVHN or IEFSD530, 
or IEFVHHB 


e Tables/work Areas: IWA, LWA, 
PIB, CVT 


QMPA, 


e Attributes: Read-only, reenterable 


e Control Section: IEFSD532 


IEFSD533: Interpreter -- Interface Routine 


This routine provides an interface 
between the reader/interpreter and system 
task control. 





e Entry: IEFIRC 
e Exits: LINK to IEFVH1 and RETURN to 
ITEESD591 


e Tables/Work Areas: CSCB, CVT, QMPA 


e Attributes: Reenterable 


e Control Section: IEFSD534 


IEFSD534: System Task Control -- LPSW 
Routine 


This routine places system task control 
in problem program mode by loading a PSW. 


e Entry: IEFSD534 
e Exit: IEFVSTRT 


e Tables/Work Areas: None 


e Attributes: Reenterable 


e Control Section: IEFSD534 


IEFSD535: System Task Control -- Problem 
Program Mode Routine 


This routine puts system task control in 
problem program mode for ABEND. 
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IEFSD536 -- IEFSD553 


e Entry: IEFSD535 


e Exit: IEEVTCTL 


® Tables/wWwork Areas: None 


e Attributes: Reenterable 


e Ccntrol Section: IEFSD535 


IEFSD536: Interpreter -- Operator Message 
Routine 


This routine writes 
operator when an I/0 


a message to the 
error or CPO full 


condition has occurred. The routine also 
sets proper indicators to cause a_ cleanur 
of the current job. 
e Entry: IEFVHR 
e Exits: Return to caller, xXcCTL to 
IEFVHN, or LINK to IEFSD308 


e Tables/Work Areas: IWA, JCT, LWA, UCB, 


CVT, PIB, CSCB, Master Scheduler resi- 
dent data area 
e Attributes: Read-only, reenterabie 





e Control Section: IEFVHR 





e Page Reference: 56 


IEFSD537: Interpreter -- Linkage Mcdule 


This routine provides an interface 
between system task control and ae reader. 
It also frees the interpreter entrance list 


(NEL) and associated areas if a reader is 
being terminated or suspended. 

e Entry: IEFSD537 

°® Exits: LINK to IEFVH1, or IEFSD531, or 


Return to system task control 


e Tables/Work Areas: NEL 





e Attributes: Read-only, reenterable 


e Control Section: IEFSD537 


IEFSD540: Initiator -- Linkage to IEFSD541 


This routine provides an interface link- 


age to IEFSD541 via an XCTL macro 
instruction. 

e Entry: IEFSD540 

e Exit: XCTL to IEFSD541 


Same as caller 


Takles/Work Areas: 


reenterable 


Attributes: Read-only, 
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e Control Section: IEFSp540 


IEFSD541: Initiator -- Data Set Integrity 


This routine enqueues on explicit data 
sets and thus prevents concurrent, and 
impairing, access between tasks. 


e Entry: IEFSD541 
e Exit: Branch to IEFSD512 


e Tables/Work Areas: LOT Block, IOB1, 


IOB2, JCT, SCT, cCSCB, SPIL, DSENQ 
Table, Minor Name List, ENQ supervisor 
list. 


e Attributes: Read-only 


e Control Section: IEFSD541 


e External References: IEFQMRAW 


e Page Reference: 62 


IEFSD551: I/O Device Ailocation -- Linkage 
to ITEFXJIMP 


This routine provides an interface link- 
age to IEFXJIMP via an XCTL macro instruc- 
tion in the 30K design package. 


e Entry: IEFV1i5XL 


e Exit: xXCTL to IEFXJIMP 


e Tables/Work Areas: Same as caller 


e Attributes: Read-only, reenterable 


e Control Section: IEFV15xXL 


IEFSD552: I/O Device Allocation -- Linkage 
to ITEFXJ IMP 


This routine provides an interface link- 
age to IEFXJIMP via an XCTL macro instruc- 
tion in the 30K design package. 

e Entry: IEFXJX5A 
e Exit: xXCTL to IEFXJIMP 
e Tables/Work Areas: Same as caller 
e Attributes: Read-only, reenterable 


e Control Section: IEFXJX5A 


IEFSD553: Initiator -- Linkage to IEFSD512 


This routine provides a linkage to 
IEFSD512 via an XCTL macro instruction. 

e Entry: IEFSD512 

e Exit: xXCTL to IEFSD512 





c 


c 


e Tables/Work Areas: Same as caller 


e Attributes: Read-only, reenterable 


e Control Section: IEFSD512 
IEFSD554: Initiator -- Linkage to IEFSD516 


This routine provides a linkage to 
IEFSD516 via an XCTL macro instruction. 


e Entry: IEFSD554 
e Exit: xXCTL to IEFSD516 


Tables/Work Areas: Same as caller 


Attributes: Read-only, reenterable 


e Control Section: IEFSD554 
IEFSD555: Initiator -- Linkage to IEFSD510 
This routine provides linkage to 
IEFSD510 via an XCTL macro instruction. 
e Entry: IEFSD555 
e Exit: XCTL to IEFSD510 





e Tables/Work Areas: Same as caller. 


e Attributes: Read-only, reenterable 


e Control Section: IEFSD555 
IEFSD556: Initiator -- Set Problem Program 


State Return 


This routine establishes the allocation 
routine ina problem program state, upon 
entry. 

e Entry: IEFSD556 
e Exit: LPSW to IEFW21SD 





e Tables/Work Areas: Same as caller. 





e Attributes: Read-only, reenterable 


e Control Section: IEFSD556 


IEFSD557: I/0 Device Allocation -- 
Interface Routine 


This routine provides an interface 
between system task control and allocation. 

e Entry: IEFW21SD 

e Exit: IEFWSD21 

e Tables/Work Areas: ECB, IOB 

e Attributes: Reenterable 





IEFSD554 -- IEFSD569 


e Control Section: IEFSD557 


IEFSD558: Initiator -- Linkage to IEFSD511 


This routine provides a linkage to 
IEFSD511 via an XCTL macro instruction. 

e Entry: IEFSD558 
e Exit: IEFSD511 
e Attributes: Read-only, reenterable 


e Control Section: IEFSD558 


IEFSD559: Initiator -- Linkage to IEFSD515 


This routine provides a linkage to 
IEFSD515 via an XCTL macro instruction. 


e Entry: SMALTERM 
e Exit: IEFSD515 


e Attributes: Read-only, reenterable 


e Control Section: IEFSD559 


IEFSD567: Nucleus -- Device-End Interrupt 


Handler Routine 


This routine handles unsolicited device- 
end interrupts from a disk storage unit. 


e Entry: IEFSD567 


e Exit: Return to caller 


e Tables/Work Areas: None 


e Attributes: Reenterable 


e Control Section: IJIEFSD567 


e External Reference: Communications 


Task TCB 


IEFSD569: Master Scheduler -- 
Initialization Routine 


This routine issues the READY message 
and formats the job queue, as well as 
typing out the automatic commands’ and 


invoking processing of the automatic com- 
mands. This routine establishes partition- 
ing of main storage at system initializa- 
tion and readies the partitions for the 


START command. This routine is called out 
at system generation by the macro, 
SGIEEOVV. 

e Entry: IEFSD569 

e Exit: Branch to dispatcher 


e Attributes: Read-only, reenterable 


Appendix B: MFT Modules 111 


IEFSD572 -- IEFSD599 


e Control Section: IEFSD569 





e Page Reference: 43 


IEFSD572: Queue Management -- Interpreter/ 
Queue Manager Interlock Routine 


This routine determines 
interlock condition exists between the 
queue manager and the reader. The routine 
issues a message requesting the operator to 
reply with either WAIT, to wait for space 
to be freed, or CANCEL, to cancel the job. 


if a possible 


e Entry: IEFSD572 

e Exits: ABEND, or return to caller 

e Attributes: Read-only, reenterable 
e Control Section: IEFSD572, IEFSD573 
e External Reference: IEFQDELO 


e Page Reference: 53 


IEFSD587: System Task Control “-- Linkage 
to IEFSD535 





This routine provides a linkage to 
IEFSD535 via a LINK macro instruction. 


e Entry: IEFSD587 


® Exit: IEFSD535 


e Attributes: Read-only, reenterable 


e Control Section: IEFSD587 


IEFSD588: System Task Control -- Linkage 
to IEE534SD 


This routine links to IEE534SD to bring 
the suspended reader into the assigned 
partition so that upon return, the initia- 
tor will be in supervisor state. 


e Entry: IEFSD588 


e Exit: LINK to IEE534SD 


Same as caller 


Tables/Work Areas: 





e Attributes: Read-only, reenterable 
e Control Section: IEFSD588 


IEFSD589: Initiator -- Linkage to IEESD534 


This routine links to system task _ con- 
trol so that upon return, the initiator 
will be in supervisor state. 


e Entry: IEFSD589 
e Exit: LINK to IEFSD534 
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e Tables/Work Areas: Same as caller 


e Attributes: Read-only, reenterable 


e Control Section: IEFSD589 


IEFSD597: Initiator -- Shared DASD ENQ/DEQ 
Purge Routine 


This routine is the purge routine for 
systems that include the shared DASD fea- 
ture. In addition to purging all resources 
enqueued by a job step, but not dequeued, 
IEFSD597 also releases reserved devices. 


e Entry: IEFSD597 
e Exit: Return to caller 


e Tables/Work Areas: Major QCB, Minor 
OCB, QEL, TCB, SVRB, CVT, ABTERM 


e Attributes: Read-only, reenterable, 
disabled 
e Control Section: IEFSD597 


IEFSD598: Initiator -- ENQ/DEQ Purge 


Routine 


This routine purges all resources 
enqueued by a job step, but not dequeued. 
e Entry: IEFSD598 
e Exit: Return to caller 
e Tables/Work Areas: Major OQCB, Minor 
OCB, QEL, TCB, SVRB, CVT, ABTERM 
e Attributes: Read-only, Reenterable, 
disabled 
® Control Section: IEFSD598 
e Page Reference: 64 
IEFSD599: Initiator -- Small Partition 
Module 
This routine provides an interface with 


the scheduler in a large partition to 
initiate and terminate small partitions. 


e Entry: IEFSD599,SMALLGO 
e Exits: ABEND, or XCTL to problem pro- 


gram or writer 
e Tables/Work Areas; SPIL, allocate 
parameter list (APL) 


e Attributes: Read-only, reenterable 


e Control Section: IEFSD599 


e External Reference: IEFQMUNC 








e Page Reference: 60 


IEFVDA: Interpreter -- DD Statement 
Processor 


This routine constructs and adds entries 


to a JFCB and SIOT from the complete 
jogical DD statement in the internal text 
buffer. 

e Entry: IEFVDA 

e Exit: To IEFVHF 


e Tables/Work Areas: 
JFCB, JCB, SCT 


IWA, LWA, SIOT, 


e Attributes: Read-only, reenterable 


e Control Section: IEFVDA 


IEFVDBSD: Interpreter -- Data Set Name 
Table Construction Routine 

This 
table. 


routine creates a data set name 


e Entry: IEFVDBSD 


e Exit: To IEFVDA 


e Attributes: Reenterable 


e Control Section: IEFVDBSD 


IEFVEA: Interpreter -- EXEC Statement 
Processor 


This routine constructs or updates an 
SCT, and, if necessary, a joblib JFCB and 
SIOT from the complete logical EXEC state- 
ment in the internal text buffer. 


e Entry: IEFVEA, from IEFVFA 
e Exit: To IEFVHF 





e Tables/Work Areas: IWA, EXEC work 
area, interpreter key table, JCT, SCT, 
SIOT, QOMPA, procedure override table. 

reenterable 


e Attributes: kead-only, 


e Control Section: LEFVEA 


IEFVFA: Interpreter -- Scan Routine 
This routine 


JOB, EXEC, 
checking 


scans the card image of a 

or DD statement, performs error 
cf JCL syntax, builds internal 
text, and, when a complete logical state- 
ment (including continuations and over- 
rides) has been scanned, passes control to 
the appropriate statement processor. 


e Entry: IEFVFA 


IEFVDA -- IEFVGK 


e Exits: To IEFVGM, IEFVHQ, IEFVHF, IEF- 


VJA, IEFVDA, IEFVEA 


e Tables/Work Areas: 
work area, 


IWA, Scan routine 
interpreter key table, QMPA, 


internal text buffer, scan dictionary. 
e Attributes: Read-only, reenterable 
e Control Section: IEFVFA 


IEFVFB: Interpreter -- Symbolic Parameter 
Processing Routine 


This routine processes symbolic parame- 
ters by creating symbolic parameter table 
buffer entries to assign values to symbolic 
parameters, and extracts those values and 
places them in the intermediate text buffer 
when a symbolic parameter is used. 


e Entry: IEFVFB 
e Exit: Return to caller 


e Tables/Work Areas: IWA, 
Intermediate Text Buffer, 


LWA SYMBUF, 
QOMPA 
e Attributes: Read-only, reenterable 


® Control Section: ITEFVFB 


IEFVGI: Interpreter -- Dictionary Entry 
Routine 


This routine constructs entries for the 
refer-back dictionary. 


e Entry: IEFVGI 
e Exit: Return to caller 


e Tables/Work Areas: Ref er- back dic- 
tionary, auxiliary work area, IWA, QMPA 


e Control Section: TEFVGI 


IEFVGK: Interpreter -- Get Parameter 
Routine 


This routine searches the internal text 
buffer for the next parameter, performs 
basic error checking, and passes control to 
the appropriate keyword routine. 


e Entry: ITEFVGK 
e Exit: Return to caller 


Local work area, 
internal text buffer, KBT, PDT. 


Tables/wWwork Areas: 
IWA, 


Control Section: InFVGK 
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IEFVGM -- IEFVGM13 


IEFVGM: Interpreter -- Message Processing 


Routine 


This routine constructs SMBS containing 
interpreter error messages and JCL state- 
ment images, assigns space for these SMBs 
in the message class output queue entry, 
and writes the SMBs into the entry. 


e Entry: IEFVGM 

e Exit: Return to caller 

® Tables/Work Areas: QMPA, SMB, SCD, 
IWA, JCT 

e Attributes: Reenterable, character 
dependence type C 

e Control Section: IEFVGM 

IEFVGM1: Interpreter -- Message Module 

This routine contains interpreter mes- 


sages 01-07. 
e Attributes: Non-executable 


e Control Section: IEFVGM1 


ITEFVGM2: Interpreter -- Message Module 


This routine 
sages Q8-OF. 


contains interpreter mes- 


e Attributes: Non-executable 





e Control Section: IEFVGM2 


IEFVGM3: Interpreter -- Message Module 


This routine contains interpreter mes- 


Sages 10-17. 
e Attributes: Non-executable 


e Control Section: IEFVGM3 


ITEFVGM4: Interpreter -~- Message Module 


This routine 
Sages 18-1F. 


contains interpreter mes- 


e Attributes: Non-executable 


e Control Section: IEFVGM4 


IEFVGM5: Interpreter -- Message Module 


This routine contains interpreter mes- 


sages 20-27. 
e Attributes: Non-executable 


e Control Section: ITEFVGM5 : 
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IEFVGM6: Interpreter -- Message Module 


This routine 


contains interpreter mes- 
sages 28-2F. 


e Attributes: Non-executable 


e Control Section: IEFVGM6 


TEFVGM7 : Interpreter -- Message Module 


This routine contains 
Sages 30-37. 


interpreter mes- 


e Attributes: Non-executable 


e Control Section: ILIEFVGM7 


IEFVGM8: Interpreter -- Message Module 


This routine 
sages 50-57. 


contains interpreter mes- 


e Attributes: Non-executable 


e Control Section: IEFVGM8 


IEFVGM9: Interpreter -- Message Module 


This routine contains 
sages 58-5F. 


interpreter mes- 


e Attributes: Non-executable 


e Control Section: IEFVGM9 


IEFVGM10: Interpreter -- Message Module 


This routine 
Sages 60-67. 


contains interpreter mes- 


e Attributes: Non-executable 


e Control Section: IEFVGM10 


IEFVGM11: Interpreter -- Message Module 


This routine contains interpreter 


sages 68-6F. 


mes- 


e Attributes: Non-executable 


e Control Section: IEFVGM11 


IEFVGM12: Interpreter -- MesSauge Module 





This routine contains interpreter res- 


sages 70-77. 


e Attributes: Non-executable 


e® Control Section: ITEFVGM1 2 


IEFVGM13: Interpreter -- Message Module 


This routine contains interpreter fes- 


sages 78-7F. 











re 


c 


c 


e Attributes: Non-executable 


e Control Section: IEFVGM13 


IEFVGM14: Interpreter -- Message Module 


This routine 
Sages 88-8F. 


contains interpreter mes- 


® Attributes: Non-executable 


e Control Section: IEFVGM14 


TEFVGM15: Interpreter Messace -- Module 


This routine contains 
Sages 90-97. 


interpreter mes- 


e Attributes: Non-executakle 


e Control Section: IEFVGM15 


IEFVGM16: Interpreter -- Message Module 


This routine 
sages AO-A7. 


contains interpreter mes- 


e Attributes: Non-executable 


e Control Section: IEFVGM16 


IEFVGM17: Interpreter -- Message Module 


This routine contains 
sages 56-5D. 


interpreter mes- 


e Attributes: Non-executable 


e Ccntrol Section: IEFVGM17 


IEFVGM18: Interpreter -- Message Module 


This routine 
sages 80-87. 


contains interpreter mes- 


e Attributes: Non-executable 


e Control Section: IEFVGM18 


IEFVGM19: Interpreter -- Message Module 


This routine contains 
sages 3E-45. 


interpreter mes- 


e Attributes: Non-executakle 


e Control Section: IEFVGM19 


IEFVGM70: Interpreter -- Message Module 


This routine 
Sages 38-3F. 


contains interpreter mes- 


e Attributes: Non-executable 


e Control Section: IEFVGM70 





IEFVGM14 -- IEFVHAA 


IEFVGM78: Interpreter -- Message Module 


This routine contains 
sages 08-OD. 


interpreter mes- 


e Attributes: Non-executable 


e Control Section: IEFVGM78& 


IEFVGS: Interpreter -- Dictionary Search 
Routine 


This routine Searches the refer-back 
dictionary for the address of a previously- 
defined SCT, SIOT, or JFCB. 


e Entry: ITEFVGS 
e Exit: Return to caller 


e Tables/Work Areas: Auxiliary work 
area, IWA, QMPA, refer-back dictionary 


e Control Section: IEFVGS 


IEFVGT: Interpreter -- Test and Store 
Routine 


This routine performs operations on a 
parameter as indicated in the appropriate 
parameter descriptor table entry. 


e Entry: IEFVGT 
e Exit: Return to keyword routine 


e Tables/Work Areas: Internal text buff- 
er, PDT, local work area, IWA 


e Control Section: IEFVGT 


IEFVHA: Interpreter -- Get Routine 


This routine reads statements from the 
input stream and the procedure library. 


e Entry: ITEFVHA 
e Exits: IEFVHC, ITEFVHE, LEFVHAA, 


IEFSD536, IEFVGM 


e Tables/Work Areas: IWA, JCT, DCB 


e Attributes: Read-only, reenterable 


e Control Section: IEFVHA 


IEFVHAA: Interpreter -- End-of-File 
Routine 


This routine determines the conditions 
under which an end-of-file condition has 
occurred, and sets switches and passes 
control accordingly. 


e Entry: ITEFVHAA 
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IEFVHB -- IEFVHG 


e Exits: ITEFVHC or IFFVHN 


Takles/wWork Areas: IWA, JCT 


e Attributes: Read-only, reenterable 


e Control Section: IEFVHAA 


ITEFVHR: Interpreter -- DD * Statement 
Generator Routine 


This routine generates a "“"SYSIN DD #*" 
statement for data in the input stream, 
when no such statement was included. 


e Entry: JIEFVHB 

e Exits: To IEFVHC, IEFVHA, IEFVGM 

e Tables/Work Areas: IWA, JCT 

e Attributes: Read-only, reenterakle 
e Control Section: IEFVHB 


IEFVHC: Interpreter -- Continuation 
Statement Routine 


This routine determines whether the cur- 
rent statement should be ae continuation, 
and, if so, determines whether it isa 
valid continuation statement. 


e Entry: JIEFVHC 

e Exits: To IEFVHEB, IEFVHCB, IEFVGM 
e Tables/Work Areas: IWA, JCT 

e Attributes: Read-only, reenterable 
e Control Section: IEFVHC 


ITEFVHCB: Interpreter -- Verk 
Identification Routine 


This routine identifies the verb in a 
control statement. 


e Entry: IEFVHCB 


e® Exits: To 
IEFVGM, IEFVHL 


IEFVHE, IEFVHM, IEFVHA, 


e Tables/Work Areas: IWA, JCT 


e Attributes: Read-only, reenterable 





® Control Section: IEFVHCB 


IEFVHF: Interpreter —-- Router 

This routine determines the conditions 
under which it was entered, and passes 
control to the appropriate routine. 


e® Ent s IEFVHE 
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e Exits: To IEFVHEB, IEFVHH, ILEFVHEC 


Tables/Work Areas: IWA 





Attributes: Read-only, reenterable 


e Control Section: IEFVHE 


ITEFVHEB: Interpreter -- Pre-Scan . 
Preparation Routine 


This routine determines whether a mes- 
sage is required or additional work queue 
Space is required before a statement is 


scanned. If so, it causes the message to 
be written or the work queue space to _ be 
assigned. 
e Entry: IEFVHEB 
e Exits: To IEFVHO, IEFVGM, IEFVHG, 
IEFVFA 


e Tables/Work Areas: IWA, JCT, SCT, QMPA 


e Attributes: Read-only, reenterable 


e Control Section: ITEFVHEB 


TEFVHEC: Interpreter -- Job Validity Check 
Routine 





This routine determines whether an _ SCT 

has been built for the current job; if not, 

the routine constructs an SCT. ) 
e Entry: IEFVHEC 
e Exits: To IEFVGM, IFFVHH 


e Tables/Work Areas: IWA, JCT, SCT 


e Attributes: Read-only, reenterable 


e Control Section: IFFVHEC 


IEFVHF: Interpreter -- Post-Scan Routine 


This routine determines the conditions 
under which it was entered, and passes 
control accordingly. 

e Entry: IEFVHF 
e Exits: To IEFVHG, IEFVHEB, IEFVHCB, 
IEFVHA 


e Tables/Work Areas: IWA, CWA : 


e Attributes: Read-only, reenterable 


® Control Section: IEFVHF 


IEFVHG: Interpreter -~- CPO Routine 


This routine writes system 
sets on a direct-access device. 
is unable to obtain enough 


input data 
If IEFVHG 
Space to con- 





plete writing a data set, control passes to 
IEFVHR. If the input reaches’ end-of-file, 
control passes to IEFVHAA. If a /* is 
found following DD DATA, control passes’ to 
IEFVHA to read the next record. If a // is 
found, control passes to IEFVHC to identify 
the verb. 


e Entry: IEFVHG 
e Exits: To IEFSD536, IEFVGM, IEFVHQ, 


IEFVHAA, IEFVHA, IEFVHC, or IEFVHB 


e Tables/Work Areas: IWA, JCT, SIOT, 
VOLT, TIOT, LWA, SCT, JFCB, UCB, QMPA, 
CWA 


e Attributes: Read-only, reenterable 


e Control Section: IEFVHG 


e Page Reference: 53 


IEFVHH: Interpreter -- Job and Step 
Enqueue Routine 


This routine places the SCT, DSNT, VOLT, 
and JCT in the job's queue entry, and 
determines whether the interpreter is to 
enqueue jobs. 


e Entry: IEFVHH 

e Exits: To IEFKG, IEFVHQ, IEFSD532, 
IEFVHHB, IEFVHN 

e Tables/Work Areas: IWA, JCT, SCT, 


QMPA, NEL 
e Attributes: Read-only, reenterable 


e Control Section: IEFVHH 


IEFVHHB: Interpreter -- Housekeeping 
Routine 


This routine initializes for merging a 
cataloged procedure. 


e Entry: IEFVHHB 
e Exits: IEFVHA, IEFVHEB 


® Tables/Work Areas: IWA 


e Attributes: Read-only, reenterable 


e Control Section: IEFVHHB 


IEFVHL: Interpreter -—- Null Statement 
Routine 


This routine determines the conditions 
under which the null statement was encoun- 
tered, and passes control to the proper 
routine. 


IEFVHH -- IEFVHQ 


e Entry: IEFVHL 

e Exits: To IEFVHCB, IEFHEC, IEFVHE, 
IEFVHA 

e Tables/Work Areas: IWA, JCT 


e Attributes: Read-only, reenterable 


e Control Section: IEFVHL 


IEFVHM: Interpreter -- Command Statement 
Routine 


for valid command 
valid, issues 


This routine tests 
verbs, and, if the verb is 


svc 34 to schedule execution of the 
command. 

e Entry: IEFVHM 

e Exits: To IEFVHA, IEFVGM 


e Tables/Work Areas: IWA, JCT 


e Attributes: Read-only, reenterable 


e Control Section: IEFVHM 


IEFVHN: Interpreter -- Termination Routine 


This routine closes the input stream and 
procedure library data sets, frees main 
storage used by the interpreter, and builds 
the interpreter exit list. 


e Entry: IEFVHN 
e Exit: Return to caller 


e Tables/work Areas: 
QMPA 


IWA, JCT, CSCB, 


e Attributes: Read-only, reenterable 


e Control Section: IEFVHN 


e Page Reference: 56 
IEFVHC: Interpreter -- Queue Management 


Interface Routine 


This routine is a common interface 
between the queue management routines and 
the interpreter. If an I/O error occurs, 
IEFVHR receives control. Queue management 
may be unable to allocate space for a job's 
input data. If, in this case, the operator 
replies CANCEL to the message which is 
issued, IEFVHG receives control. 


e Entry: IEFVHQ 
e Exits: Return to caller, IEFSD536, or 
IEFVHG 


e Tables/Work Areas: 
CSCB 


IWA, JCT, QMPA, 


Appendix B: MFT Modules 117 


Form Y27-7128-3, Page Revised by TNL Y28-2349, 


IEFVH1 -- IEFVMFAK 


® Attributes: Read-only, reenterable 


e Control Section: IEFVHQ 


IEFVH1: Interpreter -- Initialization 
Routine 


This routine initializes the interpret- 
er; it obtains main storage for and ini- 
tializes the IWA, local work areas, and 
DCBs. 

e Entry: IEFVH1 
e Exit: To ILEFVH2 
e Tables/Work Areas: UCB, CSCB, IWA, 


DCB, local work area 


e Attributes: Not reusable 


e Control Section: IEFVH1 


IEFVH2: Interpreter -- Initialization 
Routine 


This routine opens the input stream data 
set and the procedure library data set, and 
obtains main storage for a buffer for 
procedure library records. 


e Entry: IEFVH2 

e Exit: To IEFVHA 

e Tables/Work Areas: IWA, UCB, TIOT 
e Control Section: IEFVH2 

e Attributes: Not reusable 


IEFVJA: Interpreter -- Job Statement 
Processor 


This routine initializes a JCT and job 
ACT from the complete logical job statement 
in the internal text buffer. 


e Entry: IEFVJA 
e Exit: To IEFVHF 


e Tables/work 
interpreter 


Areas: MIWA, 
key table, JCT, 


job work area, 
ACT, QMPA 


e Attributes: Read-only, reenterable 


e Control Section: IEFVJA 
IEFVJIMP: Termination --~- JOB Statement 
Condition Code Processor 


This routine tests the condition codes 
specified in the JOB statement to determine 
whether the remaining steps in the job are 
to be run. 
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e Entry: IEFVJ 


e® Exits: To IEFVK or IEFZA 


e Tables/Work Areas: LCT, JCT, SCT 


® Control Section: IEFVJ 


IEFVJMSG: Termination -- JOB Statement 
Condition Code Processor Messages 


This routine contains the messages 
issued to the programmer by the JOB. state- 
ment condition code processor. 


e Entry: IEFVJMSG 


e Attributes: Non-executable 


e Control Section: IEFVJMSG 


IEFVKIMP: I/0 Device Allocation -- EXEC 
Statement Condition Code Processor 


This routine tests the condition codes 
specified in the EXEC statement to deter- 
mine whether the next step of the job is to 
be run. 


e Entry: IEFVK 

e Exits: IEFVS, IEFLB 

e Tables/work Areas: JCT, LCT, SCT 

e Control Section: IEFVK 
IEFVKMSG: I/O Device Allocation -- EXEC 
Statement Condition Code Processor Messages 

This routine contains the messages 

issued to the programmer by the EXEC -- 
statement condition -- code processor. 

e Ent : IEFVKMJ1 


e Attributes: Non-executable 


e Control Section: IEFVKMSG 


IEFVMFAK: I/O Device Allocation -- Linkage 
to IEFVMLS1 


This routine passes control to entry 
point IEFVMCVL of the JFCB housekeeping 
module IEFVMLS1 via the XCTL macro 
instruction. 


e Entry: IEFVMCVL 


e Exit: To IEFVMCVL 


e Control Section: IEFVMCVL 





Form Y¥27-7128-3, Page Revised by TNL Y28-2349, 


IEFVMLS1: I/0 Device Allocation -~ JFCB 
Housekeeping Control Routine and Allocate 
Processing Routines 








The control routine obtains the required 
SIOTs, determines the processing required 
for each, and passes control to the appro- 
priate routine. The allocate processing 


11/15/68 
IEFVMLS1 


routine performs the processing required in 
certain refer-back situations, when the 
data set is cataloged or passed, and when 
unit name is specified. 


e Entry: IEFVM, VM7000, VM7060, VM7090, 
VM7055, VM7070, VM7065 
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e Exits: To IEFVM2LS, IEFVM3LS, 
IEFVM4LS, IEFVMSLS, IEFVM6LS, and 
ITEFXCSSS 

e Tables/Work Areas: LCT, JCT, PDO, 
SIOT, JFCB, QMPA 

e Control Section: IEFVM1 

IEFVMLS6: I/O Device Allocation -- JFCB 


Housekeeping Error Message Processing 


Routine 


This routine prepares error messages for 
the JFCB housekeeping routines. 


e Entry: IEFVMSGR 
e Exit: Return to caller 

e Tables/Work Areas: JCT, LCT 
e Control Section: IEFVM6 


IEFVMLS7: I/O Device Allocation -- JFCB 
Housekeeping Error Messages 


This routine contains the messages 
issued by the JFCB housekeeping routines. 

e Entry: IEFVM7 

e Attributes: Non-executable 





e Control Section: IEFVM7 


IEFVMMS1: I/0 Device Allocation -- Linkage 
to JFCB Housekeeping 


This routine provides a linkage to the 
JFCB housekeeping routines for the ster 
flush function. 


® Entry: IEFVM1 
e Exit: To IEFVMi1 


e Attributes: Read-only, reenterable 





e Control Section: IEFVM1 





IEFVPOST: I/O Device Allocation -- 
Unsolicited Device Interrupt Handler 


This routine handles the posting of 
unsolicited device interruptions for I/0 
device allocation operating ina multipro- 
gramming environment. 





e Entry: IEFDPOST 


e Exits: To IEAOPT01 or Return to caller 
e Tables/Work Areas: CSCB, ECB, TCB 


e Attributes: Read-only, 
disabled, resident 


reenterable, 


IEFVMLS6 -- IFFVMSLS 


e Control Section: IEFDPOST 


IEFVM2LS: I/0 Device Allocation -- JFCB 
Housekeeping Fetch DCB Processing Poutine 


This routine updates the S1OT, SCT, JFCB 
and VOLT with information required for the 
allocation of devices for the fetch DCB. 


e Entry: VM7100 
e Exit: To IEFVMLS1 
e Tables/Work Areas: LCT, Sct, SI0tT, 
JFCB, VOLT 
e Control Section: IEFVM2 
IEFVM3LS: I/O Device Allocation -- JFCB 


Housekeeping GDG Single Processing Routine 


This routine obtains the fully qualified 
name of a member of a GDG, and completes 
the required information in the JFCB, VOLT, 
and SIOT for that member. 


e Entry: VM/150 
e Exit: To ITEFVMLS1 


e Tables/Work Areas: LCT, SIOT, GDG Bias 


Count table, JFCB 


e Control Section: IEFVM3 
IEFVM4LS: I/0 Device Allocation -- JFCB 
Housekeeping GDG All Processing Routine 

This routine builds an SIOT, JFCB, and 

VOLT, and PDQ entries for each member of 
the GDG. 

e Entry: VM7200 

e Exit: To IEFVMLS1 

e Tables/Work Areas: LCT, SCT, VOLT, 

PDQ, SIOT, JFCB 
e Control Section: IEFVM4 


IEFVM5LS: I/0 Device Allocation -~ JFCB 
Housekeeping Patterning DSCB Routine 

This routine establishes DCB control 
information within a JFCB. 

e Entry: VM7300 

e Exit: To IEFVMLS1 

e Tables/Work Areas: LCT, ‘SCr; °SIOT, 

DSCB, JFCB 
e Control Section: IEFVM5 
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IEFVM/76 -- IEFWDOO1 


TEFVM76: I/O Device Allocation -- JFCB 
Housekeeping Unique Volume ID Routine 


This routine creates unique volume 
serials for unlabeled tape data sets, when 
the disposition is "PASS". 


e Entry: VM7600 
e Exit: Return to caller 


Tables/wWork Areas: SIOT, JFCB, JFCBX 


Control Section: IEFVM76 





IEFVSD12: Interpreter -- CPC Allocation 
Subroutine 


This routine sets up a JFCB and allo- 
cates space on a direct-access device for a 
system input data set. 


e Entry: ITEFSD012 
e Exit: Return to caller 


e@ Attributes: Reenterable 


e Tables/Work Areas: IWA, QOMPA, 
SIOT, TIOT, UCB, JFCB, JCT, CSCB 


LWA, 


e Control Section: IEFSD012 


e External References: IEFVHOQ 


IEFVSD13: Interpreter -- SCD Construction 
Routine 


This routine constructs an SCD entry for 
each system output class defined for a job, 
and assigns space for all DSBs that will be 
required. 


e Entry: IEFSD090 
® Exit: Return to caller 


e Tables/Work Areas: IWA, QMPA, DD work 
area, SCD, SCT, SIOT, JCT, JFCB 


e Control Section: TEFSD090 


IEFWAOQO: I/0 Device Allocation -- Demand 
Allocation Routine 


This routine establishes data set device 
requirements, and allocates in response to 
specific unit requests. 


e Entry: JIEFWA000, IEFUCBL 
e Exits: To IEFWDOOO, IEFX3000, IEFX5000 


e Tables/Work Areas: UCB Address List, 
DMT, UCB, LCT, SCT, SIOT, VOLT, AWT 


e Control Sections: IEFWA7, IEFWA002 
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IEFWCFAK: 1/0 Device Allocation -- Linkage 
Module 


This routine passes control to the TIOT 
construction routine. 


e Entry: IEFWCO0O0O 


e Exit: To IEFWCIMP 


e Control Section: IEFWC00O0 


IEFWCIMP: I/0 Device Allocation -- TIOT 
Construction Routine 


This routine calculates the main storage 
required for the TIOT, builds the TIOT, and 
processes requests for direct-access space. 


e Entry: IEFwWC000 
e Exits: To IEFXJIMP, IEFWDIMP 
e Tables/Work Areas: JCT, SCT, LCT, 


SIOT, VOLT, AWT, TIOT 


e Control Section: IEFWCO00O0 


IEFWDFAK: I/O Device Allocation -- Linkage 
Module 


This routine passes control to the 
external action routine. 


e Entry: IEFWDOOO 


e Exit: To IEFWDO0O0O0 


e Control Section: IEFWDOO0O 


IEFWDOOO: I/O Device Allocation -- 
External Action Routine 


This routine causes the correct volumes 
for the step to be mounted on the appropri- 
ate units. 


e@ Entry: IEFWDOO0O 
® Exits: To IEFXTO00, IEFW41SD, IEFXK000 


e Tables/Work Areas: SCT, LCT, TIOT, UCB 


e Control Section: IEFWDOOO 


IEFWD001: I/0 Device Allocation -- 
External Action Messages 


This routine contains a directory and 
the messages used in the external action 
routine. 

e Entry: IEFWDOO1 


e Attributes: Non-executable 


e Control Section: IEFWDOO1 








IEFWSTRT: I/O Device Allocation -- Message 
Module 


This routine contains the message issued 
to the operator when a job is started and 
the messages issued to the operator when a 
job is terminated due to ABEND, condition 
codes, or JCL errors. 


e Entry: TEFWSTRT 


e Attributes: Non-executable 


e Control Section: IEFWSTRT 


IEFWSWIN: I/O Device Allocation -- Linkage 
Module 


This routine passes control to the deci- 
sion allocation routine. 


e Entry: IEFWSWIT 


e Exit: To IEFX5000 


e Control Section: IEFWSWIT 


IEFWIERM: Termination -- Message Module 


This routine contains the message issued 
to the operator when a job is terminated 
normally, or when it is terminated because 
of a JCL error found in the interpreter or 
initiator. 


e Entry: IEFWTERM 


e Attributes: Non-executable 


e Control Section: IEFWTERM 


IEFXAMSG: I/O Device Allocation -- Message 
Module 


This routine contains the messages 
issued by the allocation control routine. 

e Entry: IEFXAMSG 
e Attributes: Non-executable 
e Control Section: IEFXAMSG 


IEFXCSSS: I/O Levice Allocation -- 
Allocation Control Routine 


This routine calculates’ table Space 
requirements and obktains the main storage 
for the tables used or built during 
allocation. 

e Entry: IEFXA 
e Exits: To IEFXJ, IEFWA, IEFWC 


e Tables/Work Areas: JCT, SCT, LCT, UCB, 


SIOT, VOLT, AWT 





IEFWSTRT -- LEFXKIMNP 


e Control Section: IFFXA 


IEFFXHOOO: I/0 Device Allocation -- 
Separation Strikeout Routine 


This routine strikes from AWT entries, 
the bits corresponding to devices’ that 
would violate separation or affinity 


requests. 


e Entry: IEFXHO00O 


e Exit: Return to caller 


e Tables/Work Areas: LCT, AWT, AVT, UCB 


e Control Section: IEFXHOO0O 


IEFXJFAK: I/0 Device Allocation -- Linkage 
Module 


This routine passes control to the allo- 
cation recovery routine. 


e Entry: IEFXJ000 


e Exit: To IEFXJIMP 


e Control Section: IFFXJ000 


IEFXJIMP: I/0 Device Allocation -- 
Allocation Recovery Routine 


This routine informs the operator of the 
allocation recovery options available, and 
passes control to the proper routine to 
comply with his request. 


e Entry: IEFXJ000, IEFV15XL, IEFXJX5A 
e Exits: To IEFXCSSS, IEFSD095, IEFW41SD 


°e Tables/Work Areas: 
UCB, SCT, SIOT 


LcT, AWT, JCT, CVT, 


e Control Section: IEFXJ000 


IEFXJMSG: I/O Device Allocation -- 
Allocation Recovery Messages 


This routine contains the messages used 


by the allocation recovery routine. 


e Entry: MSRCV, MSSYS, MSOFF 


e Attributes: Non-executable 


e Control Sections IEFXJMSG 


IEFXKIMP: I/0 Device Allocation -- 
Non-Recovery Error Routine 


This routine cancels the step when a 
lack of available devices has been discov- 
ered after the TIOT is constructed. 


e Entry: IEFXK000 
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IEFXKMSG -- IEFX5000 








e® Exit: To IEFW41SD 
e Tables/Work Areas: LCT, SCT, UCB, TIOT 
e Control Section: IEFXK000 


IEFXKMSG: I/O Device Allocation -- 
Non-Recovery Error Routine Messages 


This routine contains the messages used 
by the non-~recovery error routine. 


e Entry: IEFXKMSG 


e Attributes: Non-executable 


e Control Section: IEFXKMSG 


IEFXTOOD: I/O Device Allocation -- Space 
Request Routine 


This routine obtains space on  direct- 
access devices for requesting data sets. 











e Entry: IEFXTO00 
e Exits: To IEFW41SD, IEFXK000, IEFWDO00 
e Tables/Work Areas: LCT, TIOT, UCB, 
JCT, SIOT, JFCB, PDQ 
e Control Section: xXTTPOO, IEFXTO0O 
IEFXTO002: I/0 Device Allocation -- TIOT 
Compression Routine 
This routine reduces the TIOT to its 
final size. 
e Entry: IEFXTOO02, XTTRDJ, XTTEB3, 
XTTEA1, XTTEAO 
e Exits: to IEFW41SD, IEFXKIMP, IEFXT003 
e Tables/Work Areas: LCT, TIOT, UCB, 
JCT, SIOT, JFCB 
e Control Section: IEFXT002 
IEFXTO003: I/O Device Allocation —- DADSM 
Error Recovery Routine 
This routine determines what action 
should be taken when the request for space 
on a particular volume fails. 
e Entry: IEFXT003, XUUHO6, XUUBOO 
e Exits: To IEFXTOOD, IEFXT002 
e Tables/Work Areas: LCT, TIOT, UCB, 
JCT, SIOT, JFCB 
e Control Section: IEFXT003 
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IEFXVMSG: I/O Device Allocation -- 
Automatic Volume Recognition Messages 


This routine contains the messages’ used 


by the automatic volume recognition (AVR) 
routine. 
e Entry: IEFXVMSG 


e Attributes: Non-executable 


e Control Section: IEFXVMSG 


IEFXVNSL: I/0 Device Allocation -- 
Automatic Volume Recognition —- 


Non-Standard Label Routine 


This routine processes non-standard 


labels for the AVR routine. 


e Entry: IEFXVNSL 


e Exit: Return to caller 


e Control Section: IEFXVNSL 


IFFXV001: I/0 Device Allocation -- 
Automatic Volume Recognition Routine 


This routine finds and allocates volumes 
pre-mounted by the operator. 


e Entry: IEFXVOO1 
e Exits: IEFWCO00, IEFX5000, IEFXJ000 
® Tables/Work Areas: JCT, SCT, AWT, AVT, 


VOLT, SIOT, LCT, UCB 
e Control Section: IEFXV001 
IEFX300A: I/0 Device Allocation -- Device 
Strikeout Routine 
This routine modifies the primary and 


secondary bit patterns in AWT entries to 
complete the allocation to a data set. 


e Entry: IEFX3000, X33B42 

e Exit: Return to caller 

e Tables/Work Areas: AWT, AVT, UCB, LCT 
e Control Section: IEFX3000 


TEFX5000: I/0 Device Allocation -- 
Decision Allocation Routine 


This routine selects devices for data 
sets with multiple unit possibilities. 
e Entry: IEFX5000, XIIB32, X55C86, 
X55D3G 
e Exits: To IEFWCO000, IEFXJ000 
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e Tables/Work Areas: LCT, AWT, AVT, UCB 
e Control Section: IEFX5000 


IEFYNIMP: Termination —- Step Termination 
Control Routine 


This routine passes control among the 
modules of the step termination routine 
and, when required, passes control to the 
job termination routine. 


e Entry: IEFYN 

e Exits: To IEFW22SD, IEFYPJB3, IEF- 
VJIMP, IEFZAJB3 

e Tables/Work Areas: JCT, SCT, LCT 


e Control Section: IEFYN 


IEFYNMSG: Termination -- Step Termination 
Control Routine Messages 


This routine contains 
required for the step termination 
routine. 


the messages 
control 


e Entry: IEFYNMSG, STRMSGO1 


e Attributes: Non-executable 


e Control Section: IEFYNMSG 


IEFYPJB3: Termination -- Step Termination 
Data Set Driver Routine 


This routine obtains SIOTs and to pass 
control to the disposition and unallocation 
routine. 


e Entry: IEFYP 


e Exits: To IEFZG, IEFYN 
e Tables/Work Areas: 


QMPA, SIOT, TCB 


LCT, TIOT, UCB, 


e Control Section: IEFYP 


IEFYPMSG: Termination -—- Step Termination 
Messages 


This routine contains the messages 
required by the step termination routine. 
e Entry: IEFYPMSG, YPPMSG1, YPPMSG2 


e Attributes: Non-executable 


e Control Section: IEFYPMSG 


IEFYSVMS: Termination ~-- Message Blocking 
Routine 


This routine blocks system messages into 
SMBs, and places SMBs into the message 
class queue entry. 
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IEFYNIMP -- IEFZGJB1 
e Entry: ITEFYS 
e Exit: Return to caller 
e Tables/Work Areas: LCT, SCT, SMB 
e Attributes: Reenterable 
e Control Section: IEFYS 


IEFYTVMS: Termination ~~ DSB Processing 


Routine 

This routine places data set blocks in 
the space reserved for them in the output 
queue entries. 

e Entry: IEFYT 

e Exit: Return to caller 

e Tables/work Areas: JCT, SCT, MTIOT, 

SIOT, QMPA, DSCB, LCT, CVT, JFCB 

e Attributes: Reenterable 

e Control Section: IEFYT 
IEFZAJB3: Termination -- Job Termination 
Control Routine 

This routine provides entry to the job 
termination routine, obtains PDQ blocks, 
and passes control to the disposition and 
unallocation routine. 

e Entry: IEFZA 

e Exits: To IEFZG, IEFW31iSD 

e Tables/wWork Areas: LCT, JCT, PDQ, UCB, 

OMPA 
e Control Section: IEFZA 


IEFZGJB1: Termination -- Disposition and 


Deallocation Routine 


This routine directs the disposition and 


deallocation of those 


to be processed at job termination: 
sets that were 
retained data sets that were not 


data 
to. 
e Entry: LEFZG, 


e Exit: 


e® Tables/Work Areas: 


LCT, QMPA, UCB 


e Control Section: 
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data sets that remain 
passed 
received, and 
referred 


not 


ZPOQM 


Return to caller 


JCT, PDQ, JFCB, 


IEFZGJI 
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IEFZGMSG -- IEF41FAK 


IEFZGMSG: Termination -—- Disposition and 
Deallocation Messages 


This routine contains the messages 
required for the disposition and dealloca- 
tion routine (IEFZGJB1). 


e Entry: IEFZGMSG 


e Attributes: Non-executable 


e Control Section: IEFZGMSG 


IEFZGST1: Termination -- Disposition and 


Deallocation Routine 


This routine directs the disposition of 
data sets as specified in the DISP field of 
the DD statement, and makes the associated 
units available for allocation to other 
data sets. 


IEFZG, ZPOQMGR1 


e Entry: 
e Exit: Return to caller 


e Tables/Work Areas: 
TIOT, UCB, JFCB, QMPA 


LCT, PDQ, SIOT, 


e Control Section: IEF2ZG 


IEFZHMSG: Termination —-- Disposition and 
Deallocation Message Routine 


to the 
for the 


This routine prepares messages 
programmer and to the operator 
disposition and allocation routines. 


e Entry: IEFZH, ZGOE60, ZKOD1, ZKOE1, 
XPS631 
e Exit: Return to caller 


e Tables/Work Areas: LCT, QMPA, SMB 


e Control Section: IEFZH 


IEFO78SD: System Output Writer -- Linkage 
Module 


This routine transfers control to module 
IEFSDO78. 


e Entry: IEFSDO78 


e Exit: To IEFSDO78 


e Attributes: Reenterable 


IEFO79SD: System Output Writer -- Linkage 
Module 


This routine transfers control to 


IEFSD079. 
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e Entry: IEFSDO79 


e Exit: To IEFSDO79 


e Attributes: Reenterable 


IEFO82SD: System Output Writer -- Linkage 
Module 


This routine passes control to the sys- 
tem output writer main processing routine. 


e Entry: IEFSDO82 


e Exit: To IEFSDO82 


e Control Section: IEFSD082 


IEFO83SD: System Output Writer -- Linkage 
Module 


This routine passes control to the 
tem output writer 
routine. 


sys- 
command processing 


e Entry: IEFSDO83 


e Exit: IEFSD083 


e Control Section: IEFSD083 


IEF300SD: System Restart -- Linkage Module 


This routine provides a linkage to the 
system restart initialization routine. 
e Entry: IEFSD300 


e Exits: To IEFSD300, IEFSDO055 


e Attributes: Reenterable 


IEF304SD:; System Restart -- Linkage Module 


This routine provides a linkage to the 
system restart scratch data sets routine. 

e Entry: IEFSD304 
e Exits: To IEFSD304, IEFSD055 
e Attributes: Reenterable 


e Control Section: IEFSD304 


IEF41FAK: I/0 Device Allocation -- Linkage 


Module 


This routine provides a linkage to the 


allocation exit routine during step flush. 
e Entry: IEFW41SD, IEFW1FAK, IEFW2FAK 
e Exit: To IEFW41SD 


e Attributes: Read-only, reenterable 


e Control Section: IEFW41SD 











APPENDIX C:  FLOWCHARTS 


This appendix includes the MFT flow- and system restart, see IBM System/360 


charts that are different from MVT. For Operating System: MVT Job Management, Pro- 
: the flowcharts on allocation, termination, gram Logic Manual, Form Y28-6660. 


Chart 01. Nucleus Initialization Program 
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Chart 02. Task Dispatcher (without Time Slicing) 
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Chart 03. 


Task Dispatcher (with Time Slicing) 
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e Chart 03. 


Task Dispatcher (with Tine Slicing) 
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e Chart O04. ABEND Control Flow 
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Chart 05. 


Communications Task 
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IEECVPM AND IEECVOC ARE CSECTS OF DEVICE 
DEPENDENT MODULES~ THE CONSOLE DEVICE(S) 
WILL DETERMINE WHICH MOOULES ARE USED. 
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Chart 06. Svc 34 Command Processing 
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Chart 0O7. 


Master Scheduler Task 
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Chart 08. Master Scheduler Resident Conmand Processor 
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Chart 09, 


Queue 
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Chart 20. Job 
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Chart 24. Small Partition Routine (Sheet 1 of 4) 
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ECB (See Event control block) 
End-of-volume (See 
Open/close/end-of-volume) 


ENC macro instruction 32,25,49 
ENC/DEQ purge routine 60 
Enqueue 

Supervisory routine 31,33 


queue manager enqueue 
routine 53,48,44,56 
Entering commands 36,37,38 
Entry to job management 
after IPL 36 
following step execution 
Event control block 
(ECB) 25,39,40,42,44,47,53,61 
(Aliso see “No work" ECB) 
Event indication list (EIL) 


36 


40 


Fixed area 9,13 
(Also see Input/output error handling, 
Svc transient area, SVCLIB partitioned 
data set, and System queue area) 

Free queue element (FQE) 18.1 

Free track queue 48,49 

FREEMAIN macro instruction 33 


General system initialization 18 
defining control program areas 
user options 18,19 

GETMAIN macro instruction 


18 
33,34 


42 


Index 155 


Form Y27-7128-3, Page Revised by TNL Y28-2349, 


Initial program loading (IPL) 13,14 
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Queues 
(See Free track queue, Input work queue, 
job queue, Output work queue, and Task 
control block) 

Queue manager 48-55 
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READY message 14,43 
Recording/recovery routines 
RELEASE command 42 
Remote job entry (RJE) 
Reply queue element (RPQE) 
Request Block (RB) 31,32 
RESET command 42 
Resident access methods 
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Resident SVC (RSVC) 


34.2 
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(Also see Nucleus initialization 
program) 
System input readers (See Reader/inter- 
preter) 
System output class directory (SCD) 62 
System output writers 65,66,15,17,35,43,48 
resident 65 
nonresident 65 
System queue area (SQA) 
System quiesce routine 
System restart 68 
System task control (STC) 


18.1,19,11,13,31 
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66-68,55, 56 
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Task control block (TCB) 
TCBFLGS field 19 
TCBRBP field 19,24 
TCBTCB field 23 
TCB queue 19, 22-26 

Task dispatching 9,22,24-29 

Task input/output table 

(TIOT) 85,87,13,57,68 

Task management 11, 22 
(Also see Contents supervision, Inter- 
ruption supervision, Main storage super- 
vision, Overlay supervision, Task super- 
vision, and Timer supervision) 

Task creation 45,47 

Task supervision 31,32,22 

Task switching 24,25 

TCB (See Task control block) 

TIOT (See task input/output table) 

Timer supervision 34.1, 22 
timer queue element 34.1,24 
timer pseudo clock 34.1 

Time-slicing 45 
CVTTSCE field of CVT 
dispatcher 28-29 

Track stacking 50 

Trans7.ent area 
input/output 13 
Svc 13,40,41 

Transient reader 55 
system assigned 56,57 
user assigned 56,57 


30,33 
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Unit control block (UCB) 
Unit control module (UCM) 
UNLOAD command 42 
User options 18 
(Also see BLDL list, Resident access 
method, Resident SVC, and System queue 
area) 


40,41 
39-42 


Validity check 42,47 


Volume table (VOLT) 15 


Volume table of contents (VTOC) 184 
WAIT macro instruction 30,25,40 
Write-to-operator 

macro instruction (WTO) 35,37-41 


queue element (WOE) 41 
Writer (See System output writers) 
WIO/WTOR (See Write to operator; Reply 
queue element) 


| XCTL macro instruction 33 


Index 157 
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Summary of Amendments 

Changes have been made in the discussions of the DEFINE command 
processing and the ABEND service routine. New items discussed 
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